API 레퍼런스

결제 조회

POST /api/searchPayment — 승인 여부를 확인하는 유일한 근거. 콜백 수신 시와 폴링 시 모두 이 API로 확인합니다.

HTTP

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

요청

필드	필수	설명
`TRANS_SEQNO`	✅	조회할 거래번호
`PLATFORM_CODE` · `STORE_CODE`	✅	결제를 만든 것과 같은 조합
`TRANS_AT`	✅	요청 시각 14자리
`API_SIGN`	✅	서명

JSON

{ "TRANS_SEQNO": "svc20260921120000123", "PLATFORM_CODE": "PC…", "STORE_CODE": "SD…",
  "TRANS_AT": "20260921120500", "API_SIGN": "…" }

응답

JSON

{
  "result_code": 0, "result_msg": "성공",
  "result_data": {
    "RESULT_CODE": "0000",
    "RESULT_MSG": "정상적으로 처리 되었습니다.",
    "TRANS_SEQNO": "svc20260921120000123",
    "APPROVE_STATUS": "APPROVE_COMPLETE",
    "MOBILE_NO": "01012345678",
    "APPROVAL_DATETIME": "20260921120135",
    "APPROVAL_AMOUNT": 128000,
    "SUPPLY_AMOUNT": 116364,
    "TAX_CHARGE": 11636,
    "APPROVAL_NUMBER": "12345678",
    "INSTALLMENT_MONTH": "00",
    "ISSUER_NAME": "신한카드",
    "ACCEPTER_NAME": "신한카드",
    "METHOD_NAME": "모바일 간편결제",
    "STORE_NAME": "테스트 가맹점",
    "CEO_NAME": "홍대표",
    "BIZ_REG_NUM": "1234567890",
    "STORE_TEL_NUM": "0212345678",
    "APPROVAL_CANCEL_DATETIME": null,
    "CANCEL_REASON": "",
    "CANCEL_AMOUNT": 0,
    "PAY_PATH": "WEB"
  }
}

필드	설명
`APPROVE_STATUS`	거래 상태. `APPROVE_COMPLETE`만 결제 성공. 상태 코드
`APPROVAL_AMOUNT`	승인금액(숫자). 주문 금액과 대사하세요
`SUPPLY_AMOUNT` · `TAX_CHARGE`	공급가액·부가세
`APPROVAL_DATETIME`	승인 시각 `yyyyMMddHHmmss`
`APPROVAL_NUMBER`	카드 승인번호
`INSTALLMENT_MONTH`	할부개월. `00` 일시불
`ISSUER_NAME` · `ACCEPTER_NAME`	발급사·매입사
`METHOD_NAME`	결제수단 표시명
`STORE_NAME` · `CEO_NAME` · `BIZ_REG_NUM` · `STORE_TEL_NUM`	가맹점 정보(영수증용)
`APPROVAL_CANCEL_DATETIME` · `CANCEL_AMOUNT` · `CANCEL_REASON`	취소 시각·취소금액(취소 완료 시 승인금액)·사유
`PAY_PATH`	결제 경로. `WEB`(링크) · `EPAY`(저장카드) · `KIOSK`/`VAN`/`CARD`(단말)

오류

`RESULT_CODE`	원인
`3001`	서명 불일치
`4003`	거래 없음 — 거래번호 오타, 또는 다른 `PLATFORM_CODE`·`STORE_CODE`로 조회
`4005`	코드 오류

사용 규칙

콜백을 받았을 때, 프런트 대기 화면 폴링(3초), 미결제 배치(1분~) 모두 이 API를 씁니다.
결과는 언제 불러도 같습니다(멱등). 승인 이후 취소가 일어나면 CANCEL_COMPLETE로 바뀝니다.
호출량 제한은 없지만 프런트 폴링은 3초 이상 간격을 권장합니다.

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