3. 결제 모니터링

이 페이지에서는 결제(Payment)와 환불(Refund)을 어떻게 확인하고 해석해야 하는지, 그리고 문제가 발생했을 때 무엇을 먼저 봐야 하는지를 설명합니다.

---

이 화면의 목적

“결제와 환불이 정상적으로 처리되었는가?”

이 화면은 결제 자체를 수행하는 곳이 아니라, 결과를 확인하고 문제를 추적하는 곳입니다.

---

1. 결제(Payment) 흐름 이해하기

KSC(ieum)에서 결제는 다음과 같이 처리됩니다.

1. 사용자/서비스에서 결제 요청 발생

2. 다날 App Backend가 on-chain 결제 실행

3. 실행 결과가 KSC SaaS에 record로 전달

4. KSC SaaS 화면에 결제 내역 표시

👉 즉, 이 화면에 보인다는 것은 👉 이미 on-chain 실행이 시도되었다는 의미입니다.

---

2. 화면에서 확인해야 할 주요 항목

(1) 결제 ID / TxHash

• 각 결제 건을 구분하는 식별자

• 문제 발생 시 가장 먼저 확인해야 할 값

👉 운영·기술 문의 시 👉 반드시 이 값을 함께 전달하세요.

---

(2) 결제 금액

• 실제 결제에 사용된 금액

• 수수료가 포함되거나 제외된 기준은 내부 정책에 따라 다를 수 있음

👉 “요청 금액”과 “실제 처리 금액”이 👉 일치하는지 확인합니다.

---

(3) 결제 상태(Status)

일반적으로 다음 상태를 가집니다.

• Completed

  • 결제 성공

  • 추가 조치 필요 없음

• Failed

  • 결제 실패

  • 원인 확인 필요

---

3. 환불(Refund) 처리 흐름

환불은 기존 결제 건을 기준으로 처리됩니다.

1. 환불 요청 발생

2. 다날 App Backend에서 환불 트랜잭션 실행

3. 환불 결과가 KSC SaaS에 record

4. 환불 내역이 결제 건과 연결되어 표시

👉 환불은 새로운 결제가 아니라, 기존 결제의 파생 이벤트입니다.

---

4. 결제 실패가 발생했을 때 확인 순서

결제가 실패하면 다음 순서로 확인하세요.

1. 결제 상태(Status) 확인

2. 에러 코드 / 메시지 확인

3. 담보·한도 상태 확인

4. 동일 요청 반복 여부 확인

대부분의 결제 실패는:

• 한도 부족

• 승인 담보 부족

• 일시적 네트워크 오류

중 하나입니다.

---

5. 실무자가 자주 겪는 상황

상황 1. 결제가 실패했는데 이유를 모르겠어요

👉 결제 상세 화면에서 👉 에러 코드와 메시지를 먼저 확인하세요.

그 다음에도 불명확하면 운영팀/기술팀에 TxHash 포함해서 문의하시면 됩니다.

---

상황 2. 환불이 되었는지 헷갈립니다

👉 환불은 결제 건 아래에 👉 별도 이벤트로 표시됩니다.

“결제 취소”가 아니라 **“환불 완료 상태”**를 확인하세요.

---

상황 3. 결제 내역이 안 보입니다

• 아직 record가 전달되지 않았을 수 있음

• 일시적 지연 가능성 있음

👉 잠시 후 새로고침 후 재확인 👉 지속되면 운영팀 확인

---

요약

• 결제 화면은 실행이 아닌 결과 확인용

• TxHash가 가장 중요한 키

• 실패 시 원인 → 한도 → 담보 순으로 확인

• 환불은 결제에 종속된 이벤트

---

다음 페이지 안내

다음 페이지에서는 정산 결과를 어떻게 확인해야 하는지를 설명합니다.