API 레퍼런스
상태 코드
게이트웨이 거래 상태(APPROVE_STATUS), 결제 경로, 청구서 상태·발송 상태의 의미입니다.
게이트웨이 거래 상태 — APPROVE_STATUS
| 값 | 의미 | 귀사 처리 |
|---|---|---|
STORE_REQUEST | 결제 대기(생성됨, 미결제) | PENDING 유지, 폴링 계속 |
APPROVE_COMPLETE | 승인 완료 — 유일한 결제 성공 | 금액 대사 후 PAID, 서비스 제공 1회 |
APPROVE_FAIL | 승인 실패(카드 거절 등). 고객이 다시 시도할 수 있음 | 대기 유지 또는 새 결제 생성 |
CANCEL_COMPLETE | 취소 완료(환불) | CANCELED |
CANCEL_FAIL | 취소 실패 | 수동 확인, 카리페이 문의 |
STORE_DELETE | 청구 삭제됨(결제 불가) | DELETED |
결제 경로 — PAY_PATH
| 값 | 의미 |
|---|---|
WEB | 결제 링크(결제 페이지)로 결제 |
EPAY | 저장카드 간편결제 |
KIOSK · VAN · CARD | 카드 단말·키오스크 승인. API 취소 불가 |
청구서 상태 — 청구 서버
status | 의미 |
|---|---|
PENDING | 미납 |
DONE | 수납완료(결제 또는 현장 수납 처리) |
CANCELED | 취소(환불 또는 수납 취소) |
sendStatus | 의미 |
|---|---|
PENDING | 발송대기(큐 처리 중) |
SENT | 발송완료(결제 링크 발급 + 알림 접수) |
FAILED | 발송실패(게이트웨이 오류·알림 접수 거절). 포인트 환급 |
NOT_APPLICABLE | 발송 대상 아님(현장결제 등) |
발송 이력 — sendHistories[]
| 필드 | 값 |
|---|---|
sendType | INITIAL 최초 발송 / RESEND 재발송 |
sendResult | SUCCESS 접수 성공 / FAILED |
sendChannel | ALIMTALK / SMS — 실제 나간 수단 |
발송 수단 — sendChannel
| 값 | 동작 |
|---|---|
ALIMTALK | 카카오 알림톡. 접수 실패 시 오류 |
SMS | 문자(LMS)만 |
ALIMTALK_THEN_SMS | 알림톡 시도 → 수신 불가·접수 거절 시 문자 대체 |
문서에 없는 내용이나 오류는 bellight@goatheaven.com 또는 지원 문의로 알려주세요.