| Doc. No. | A7S10V1 | ||
|---|---|---|---|
| API Title | 결제 > 결제 망취소 요청 | ||
| API Description | 일회용 Token을 이용한 결제의 망취소 요청 API 입니다. 원거래 요청에 대한 응답을 받지 못했을 시에 해당 api를 사용하여 원거래를 무효처리할 수 있습니다. 원거래 요청데이터로 전달한 transactionId와 가맹점ID를 요청 데이터로 받아 원거래를 조회하고, 그 거래를 망취소 처리합니다. |
||
| Protocol | HTTP | Interface Type | SYNC |
| HTTP METHOD | POST | Request URL | /api/v1/payment/netcancel/no-hce |
| Data Encryption | Request : YES / Response : NO | ||
| Field | Type | Length | MOC | Description | ||
|---|---|---|---|---|---|---|
| merchantId | STRING | 15 | MANDATORY | 원거래 요청데이터의 merchantId | ||
| transactionId | STRING | 28 | MANDATORY | 원거래 요청데이터의 transactionId | ||
| Field | Type | Length | MOC | Description | ||
|---|---|---|---|---|---|---|
| balance | NUMBER | 0~999999999999 | MANDATORY | 카드 잔액 | ||
| approvalTime | STRING | 17 | MANDATORY | 서버 취소승인시간 - 형식 : yyyyMMddHHmmssSSS |
||
| response | OBJECT | MANDATORY | 응답 결과 값 | |||
| └ code | STRING | 1~7 | MANDATORY | 응답 결과 코드 | ||
| └ description | STRING | 1~255 | MANDATORY | 응답 결과 상세 설명 | ||
| HTTP Status | Error code | Message | Description |
|---|---|---|---|
| 프로토콜 항목의 "공통 Error Message 정보"에서 추가 확인 바랍니다. | |||
| 400 | 006_021 | Request for duplicated transaction | 이미 취소된 거래입니다. |
| 400 | 006_022 | System Error | 시스템 실패입니다. |
| 400 | 006_030 | No original transaction. | 원거래 정보가 없습니다. |