DEVELOPER REFERENCE

공개 규격으로 구현하고,
승인 후 호출합니다.

SDK와 요청·응답 규격은 공개되어 있습니다. BASE_URL 자격정보와 플랫폼·STORE·API Key는 가맹·CAT·STORE 확인 후 발급합니다.

결제 요청결과 확인결제 취소

공개 범위 · SDK와 OpenAPI
코드와 규격은 누구나 검토할 수 있습니다. 테스트·운영 게이트웨이 호출은 가맹 승인, CAT·STORE 연결과 보안 확인이 끝난 파트너에게만 열립니다.

PAYMENT LIFECYCLE

저장해야 할 결제 상태 흐름

화면 이동이나 Callback 본문만 믿지 않고 조회 API의 승인 상태와 금액으로 주문을 확정합니다.

READY · 결제 대기

→

PAID · 승인 완료

→

PARTIAL_CANCEL · CANCELLED

실패·만료·중복 알림 상태명과 전이 규칙은 최종 계약 문서에서 고정합니다.

게이트웨이 엔드포인트

Method	Path	Purpose	Status
POST	/api/requestPayment	결제 생성·링크 발급	승인 후 호출
POST	/api/searchPayment	결제 상태·승인금액 조회	승인 후 호출
POST	/api/requestPaymentCancel	전액·부분 취소 또는 미결제 삭제	승인 후 호출
POST	파트너 CONFIRM_URL	결제 완료 알림	파트너 구현

요청 예시

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

{
  "TRANS_SEQNO": "svc202609070001",
  "PLATFORM_CODE": "{PLATFORM_CODE}",
  "STORE_CODE": "{STORE_CODE}",
  "TRANS_AT": "20260907120000",
  "APPROVAL_AMOUNT": "128000",
  "MOBILE_NO": "01012345678",
  "PAY_USER_NAME": "홍길동",
  "REQUEST_REASON": "9월 이용료",
  "CONFIRM_URL": "https://partner.example/caripay/callback",
  "orderType": "BILL",
  "API_SIGN": "{SHA256_HEX}"
}

응답 예시

{
  "result_data": {
    "RESULT_CODE": "0000",
    "TRANS_SEQNO": "svc202609070001",
    "APPROVE_STATUS": "STORE_REQUEST",
    "REDIRECT_URL": "{PAYMENT_URL}"
  }
}

BASE_URL

테스트·운영 주소와 자격정보를 파트너별 분리 발급

인증

API_SIGN = SHA-256(거래번호 + 플랫폼 + STORE + 시각 + API Key)

금액

APPROVAL_AMOUNT는 브라우저가 아닌 파트너 서버에서 결정

콜백 검증

Callback 수신 후 searchPayment로 승인 상태·금액 재확인

오류

HTTP 200이 아니라 result_data.RESULT_CODE=0000으로 성공 판정

대사

TRANS_SEQNO·승인금액·취소금액 기준으로 주문과 일 단위 확인

연동 시작 게이트

1.사업자·판매자·정산 명의 확정
2.VAN 가맹 승인
3.CAT ID·STORE 연결
4.BASE_URL·플랫폼·STORE·API Key 발급
5.생성·조회·취소·중복 Callback UAT
6.장애 연락망·대사·환불 책임 확정

SDK 저장소 테스트·운영 자격정보 신청

공개 규격으로 구현하고,승인 후 호출합니다.