[Webhook] 가상계좌 입금 완료

센트비즈는 가상계좌 입금처리가 성공적으로 완료된 후, 고객사에게 입금이 완료되었음을 고객사 Callback URL로 웹훅을 전송합니다.

+---------+        Webhook POST        +-------------+
| SentBiz | -------------------------> | Client API  |
+---------+                            +-------------+
  • 고객사는 사전에 센트비즈에 Webhook URL 과 webhook key 를 공유해야 하고, 방화벽 오픈작업이 되어있어야 합니다.
  • 센트비즈는 본 웹훅의 응답을 수신한 후, result 값이 SUCCESS 가 아닌 건에 대해 재시도를 합니다.
  • 재시도 정책: 10분 간격으로 총 12회

고객사는 본 웹훅을 수신하면 내부 처리를 진행하고 아래의 파라미터들을 이용하여 응답합니다.
고객사의 결과(result) 응답에 대한 정책은 다음과 같습니다.

  • 결과(result)가 SUCCESS : Webhook 발송 및 재시도 종료
  • 결과(result)가 FAILED : 10분 간격으로 총 12회까지 발송 재시도

고객사는 이미 수신이 되었거나, SUCCESS된 웹훅에 대해 동일 웹훅이 수신될 경우 내부 시스템에서 중복처리가 되지 않도록 조치가 필요합니다.
즉, 결과(result)가 SUCCESS 처리되었음에도 동일한 transaction_id로 webhook을 수신받을 경우

  • 내부처리를 제외(skip)합니다.
  • {transaction_id: [해당 동일한 transaction_id], result: SUCCESS}로 응답합니다.

고객사의 Response 는 반드시 아래 사항을 준수해야 합니다.

  • Header : 'content-type: application/json' 명시
  • 성공 응답일 경우 http status: 200 으로 응답
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

사전에 공유된 고객사의 Webhook URL

Body Params
string

가상계좌 입금 거래 ID

string

가상계좌 발급 거래 ID

string

상점 ID

string
enum
required

웹훅 타입

Allowed:
Headers
string
required

고객사 URL 인증용 키

Response

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json