결제 취소
본 페이지에서는 결제 취소 요청에 대해 설명합니다. 결제 승인 후 취소 처리가 필요할 때 사용됩니다. 부분 취소 여부 필드에 따라 전체 취소 또는 부분 취소로 처리됩니다.
결제 취소 호출 데이터 예시
# 취소 호출 예시
Method : POST
Content-Type : application/json
{
"tid"="123121234m010123092298e2f66031",
"mId"="123121234m",
"orderId"="1695366183394",
"cancelAmount"="1004",
"ccId"="김씨드",
"ccNm"="김씨드",
"ccMsg"="테스트 결제 취소",
"ccIp"="127.0.0.1",
"partCanFlg"="0",
"mbsReserved"="우우우",
"ediDate"="20230922161300",
"hashString"="28e5d859d86bec63e432eed4d8806811c1667fc3a6d337d21aebf0b3e692adff",
}결제 취소 파라미터
결제 취소 요청
URL : /payment/v1/cancel Protocol : HTTP/1.1 Method : POST Encoding : UTF-8 Content-Type : Content-Type: application/json
tid
(30byte)
인증 거래번호
mId(21byte)
상점 아이디
orderId(40byte)
주문 번호 주문한 결제를 식별하는 역할로, 결제를 요청할 때 가맹점에서 만들어서 사용한 값입니다. 중복되지 않는 고유한 값을 발급해야 합니다.
cancelAmount(15byte)
취소 금액
ccId(21byte)
취소 아이디, 한글/특수기호 입력가능
ccNm(30byte)
취소자 명
ccMsg(100byte)
취소 사유
ccIp(20byte)
취소 아이피(IPv4, IPv6 지원)
partCanFlg(1byte)
부분 취소 여부 0 : 전체취소 1 : 부분취소
mbsReserved(500byte)
상점 예약 필드에 셋팅한 값
ediDate(14byte)
인증처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133
hashString
결제정보 검증 데이터 (mid + ediDate + tid + 가맹점KEY) 인증 데이터 정합성을 위해 가맹점에서 HASH값 비교
goodsSplAmt(15byte)
공급가
goodsVat(15byte)
부가세
goodsSvsAmt(15byte)
상품 봉사료
rfndBankCd(4byte)
환불 은행 코드
rfndAcntNo(20byte)
환불 계좌번호
rfndAcntNm(20byte)
환불 계좌주
결제 취소 응답
resultCd(4byte)
인증에 대한 성공, 실패 코드
: 0000
: 0000을 제외한 나머지
resultMsg(100byte)
결과 메시지
tid(30byte)
인증 거래번호
mId(21byte)
상점 아이디
trDt(8byte)
취소 일 형태 : HHmmss 예시) 152623
trTm(6byte)
취소 시간 형태 : yyyyMMdd 예시) 20230915
trxStCd(2byte)
거래 상태 0 : 승인 1 : 전취소 2 : 후취소 3 : 채번완료 4 : 채번취소 9 : 망취소
method(2byte)
결제 수단 코드 01 : 신용카드 02 : 계좌이체 03 : 가상계좌
spmCd(2byte)
결제 수단 Sub 코드 01 : 고정
cancelAmount(15byte)
결제 취소 결과 금액
orderId(40byte)
주문 번호 주문한 결제를 식별하는 역할로, 결제를 요청할 때 가맹점에서 만들어서 사용한 값입니다. 중복되지 않는 고유한 값을 발급해야 합니다.
otid(30byte)
원거래 아이디
partCanFlg(1byte)
부분 취소 여부 0 : 전체취소 1 : 부분취소
netCanFlg(500byte)
망취소 여부 0 : 일반취소 1 : 망취소
mbsReserved(500byte)
상점 예약 필드에 셋팅한 값
ediDate(14byte)
인증처리 일시 형태 : YYYYMMDDHHmmss 예시) 20230914135133
Last updated