API 레퍼런스

결제 취소·청구 삭제

POST /api/requestPaymentCancel — 승인 결제의 전액 취소(CANCEL)와 미결제 청구 삭제(DELETE).

HTTP

POST {BASE_URL}/api/requestPaymentCancel
Content-Type: application/json

요청

필드	필수	형식	설명
`TRANS_SEQNO`	✅		대상 거래번호
`PLATFORM_CODE` · `STORE_CODE`	✅		결제를 만든 것과 같은 조합
`TRANS_AT`	✅	14자리	요청 시각
`REQUEST_TYPE`	✅	`CANCEL` / `DELETE`	취소(환불) / 미결제 삭제
`APPROVAL_AMOUNT`	✅	`^\d{1,12}$`	`CANCEL`: 승인금액과 같아야 함(전액). `DELETE`: 청구금액
`MOBILE_NO`	✅	`^\d{9,11}$`	고객 휴대폰
`API_SIGN`	✅		서명

JSON

{ "TRANS_SEQNO": "svc20260921120000123", "PLATFORM_CODE": "PC…", "STORE_CODE": "SD…",
  "TRANS_AT": "20260921130000", "REQUEST_TYPE": "CANCEL", "APPROVAL_AMOUNT": "128000",
  "MOBILE_NO": "01012345678", "API_SIGN": "…" }

응답

JSON

{ "result_code": 0, "result_msg": "성공",
  "result_data": { "RESULT_CODE": "0000", "RESULT_MSG": "정상적으로 처리 되었습니다.",
    "TRANS_SEQNO": "svc20260921120000123", "MOBILE_NO": "01012345678", "APPROVAL_AMOUNT": 128000, "TEMP_VALUE": "order-8812" } }

DELETE 성공 응답은 RESULT_CODE·RESULT_MSG만 담깁니다.

규칙

CANCEL은 부분 취소 불가. APPROVAL_AMOUNT가 승인금액과 다르면 거절됩니다.
이미 CANCEL_COMPLETE인 거래는 다시 요청해도 0000(멱등).
카드사 취소 실패 → RESULT_CODE: "4004", 상태 CANCEL_FAIL. 조회 후 카리페이에 문의.
DELETE는 결제 전 청구에만. 삭제 후 상태 STORE_DELETE.
단말·키오스크 승인 건(PAY_PATH KIOSK/VAN/CARD)은 4008 — 승인한 단말에서 취소.

오류

`RESULT_CODE`	원인
`3001`	서명 불일치
`4004`	취소 대상 거래 없음 / 카드사 취소 실패
`4005`	코드 오류
`4006`	가맹점의 온라인 단말(CAT) 정보 없음 — 카리페이 문의
`4008`	단말 승인 건은 키오스크에서 취소
금액 불일치	`result_msg: 결제 취소 요청 금액이 원거래 승인금액과 일치하지 않습니다.`

문서에 없는 내용이나 오류는 bellight@goatheaven.com 또는 지원 문의로 알려주세요.