결제 망취소 요청

API Description

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

Request Parameter

Field Type Length MOC Description
merchantId STRING 15 MANDATORY 원거래 요청데이터의 merchantId
transactionId STRING 28 MANDATORY 원거래 요청데이터의 transactionId

Response Parameter

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 응답 결과 상세 설명

Response Code

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. 원거래 정보가 없습니다.

Example

Request


            

Response