결제 취소

본 페이지에서는 결제 취소 요청에 대해 설명합니다. 결제 승인 후 취소 처리가 필요할 때 사용됩니다. 부분 취소 여부 필드에 따라 전체 취소 또는 부분 취소로 처리됩니다.

---

결제 취소 호출 데이터 예시

# 취소 호출 예시
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