결제 취소/환불 API
승인된 결제를 취소하거나 환불 처리합니다.
결제 취소/환불
승인된 결제에 대해 전체 또는 부분 취소를 요청합니다.
API 정보
POST/v1/api/pay/cancel
Content-Type
application/json; charset=UTF-8테스트
https://tbnpay.settlebank.co.kr/v1/api/pay/cancel운영
https://npay.settlebank.co.kr/v1/api/pay/cancel요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*전문정보 코드
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*상점아이디
상점아이디
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점 취소주문번호 (원거래 번호 아님)
상점 취소주문번호 (원거래 번호 아님)
└mchtCustIdAN(100)영문+숫자, 최대 100byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)고객아이디고객아이디
└mchtTrdDtAN(8)영문+숫자, 최대 8byte*취소주문일자 (yyyyMMdd)
취소주문일자 (yyyyMMdd)
└mchtTrdTmAN(6)영문+숫자, 최대 6byte*취소주문시간 (HH24MISS)
취소주문시간 (HH24MISS)
└trdAmtN(13)숫자, 최대 13byte*취소(환불) 금액
취소(환불) 금액
└trdNoAN(50)영문+숫자, 최대 50byte*원거래번호 (결제 시 발급된 번호)
원거래번호 (결제 시 발급된 번호)
└custAcntSumryAN(30)영문+숫자, 최대 30byte통장인자내용 (한글 3byte)
통장인자내용 (한글 3byte)
└splAmtN(13)숫자, 최대 13byte공급가액
공급가액
└vatN(13)숫자, 최대 13byte부가세
부가세
└svcAmtN(13)숫자, 최대 13byte봉사료
봉사료
└custIpAN(15)영문+숫자, 최대 15byte고객 IP 주소
고객 IP 주소
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-256 해쉬값(실시간 생성)SHA-256 해쉬값
NOTE
해쉬 생성 조합
mchtId + mchtCustId + mchtTrdDt + mchtTrdTm + trdAmt(평문) + trdNo + hashKey
응답 파라미터
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드
0021거래상태코드
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드
0000거절코드
└outRsltMsgAN(300)영문+숫자, 최대 300byte*결과메시지
정상처리되었습니다.결과메시지
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*취소 주문번호
OID201902210001취소 주문번호
└trdNoAN(40)영문+숫자, 최대 40byte*취소 거래번호
STFP_FIRM12345678901234567890취소 거래번호
└trdAmtN(13)숫자, 최대 13byte*환불된 금액
1000환불된 금액
