API 레퍼런스
결제 완료 콜백
POST {CONFIRM_URL} — 결제 승인 시 카리페이가 귀사 서버로 보내는 알림의 규격입니다.
결제 생성 때 넘긴 CONFIRM_URL로 카리페이가 POST(JSON) 합니다. 구현 지침은 콜백 구현을 보세요.
HTTP
POST {CONFIRM_URL}
Content-Type: application/json본문
| 필드 | 형식 | 설명 |
|---|---|---|
RESULT_CODE | "0000" | 결제 성공 |
RESULT_MSG | 문자열 | 비어 있을 수 있음 |
TRANS_SEQNO | 문자열 | 거래번호 — 주문을 찾는 키 |
MOBILE_NO | 문자열 | 고객 휴대폰 |
APPROVAL_AMOUNT | 문자열 | 승인금액. 확정은 조회 API로 |
TEMP_VALUE | 문자열 | 결제 생성 때의 TEMP_VALUE |
ORDER_TYPE | BILL/SHOP | 주문 유형 |
txId | 문자열 | 게이트웨이 내부 거래 ID(플랫폼ID_가맹점ID_TRANS_SEQNO) |
cardCompany | 문자열 | 발급 카드사 |
installment | 문자열 | 할부개월. 0/00/null 일시불 |
approvalNumber | 문자열 | 승인번호 |
approvalDatetime | 문자열 | 승인 시각 yyyyMMddHHmmss |
payerName | 문자열 | 결제자명 |
JSON
{ "RESULT_CODE": "0000", "RESULT_MSG": "", "TRANS_SEQNO": "svc20260921120000123",
"MOBILE_NO": "01012345678", "APPROVAL_AMOUNT": "128000", "TEMP_VALUE": "order-8812",
"ORDER_TYPE": "BILL", "txId": "12_34_svc20260921120000123", "cardCompany": "신한카드",
"installment": "00", "approvalNumber": "12345678", "approvalDatetime": "20260921120135", "payerName": "홍길동" }귀사 응답
HTTP 200(2xx). 본문은 무시됩니다. 2xx가 아니면 재시도합니다(아래).
전송 규칙 요약
- 승인 직후 큐에 적재, 5초 간격 발송. 실패하면 5초부터 두 배씩 늘린 간격(최대 1시간)으로 최대 30회(약 21시간) 재시도.
https://URL만.http://는 전송되지 않음.- 관리자 콘솔 취소 시 같은 URL로 취소 알림이 갈 수 있음 — 콜백 핸들러는 상태를 조회 API로 다시 읽어 처리.
X-Webhook-Signature헤더는 카리페이 내부 검증용 — 파트너는 본문을 승인 근거로 쓰지 말고 조회 API로 확정할 것.
문서에 없는 내용이나 오류는 bellight@goatheaven.com 또는 지원 문의로 알려주세요.