망취소 API 연동하기

1. 망취소 API Flow

2. 설명 (Description)

• 인증 응답 후 승인 요청 시 정상적으로 응답 데이터를 수신하지 못했거나 가맹점의 내부 서버 이슈 등으로 인해 승인 응답 데이터를 정상적으로 처리하지 못한 경우, 망취소 API를 활용하여 거래 내역 불일치 이슈를 방지할 목적으로 사용합니다.
• 망취소 요청 및 응답 시 모든 값은 server-side에서 처리해야 하며 민감 정보가 외부에 노출되지 않도록 주의해야 합니다.

---

3. 요청 (Request)

3.1. HTTP Request

• Method: POST
• URL: 인증 응답 시 NetCancelURL 파라미터로 응답된 URL
• Content-Type: application/x-www-form-urlencoded
• Encoding: EUC-KR

3.2. 요청 파라미터

필드명	크기(byte)	필수	설명
TID	30	O	망취소 요청할 거래 아이디 (인증 응답 TxTid 사용)
AuthToken	40	O	인증 토큰
MID	10	O	가맹점 아이디
Amt	12	O	망취소 요청 금액 (거래 금액과 동일한 값으로 설정)
EdiDate	14	O	요청 전문 생성 일시(YYYYMMDDHHMISS)
NetCancel	1	O	망취소 여부 ('1' 고정)
SignData	256	O	위변조 검증 데이터, 생성규칙: hex(sha256(AuthToken + MID + Amt + EdiDate + MerchantKey))
CharSet	10		인증 응답 인코딩 (euc-kr(default) / utf-8)
EdiType	10		응답전문 유형 (JSON(default) / KV) *KV:Key=value
MallReserved	500		가맹점 여분필드 (나이스페이 가공 없음)

---

4. 응답 (Response)

4.1. 응답 파라미터

PG사의 기능 추가 및 서비스 개선에 따라 응답 필드는 사전 고지 없이 추가될 수 있습니다. 가맹점에서는 아래 표에 기재되지 않은 응답 필드가 추가될 수 있음을 고려하여 연동해야 하며, 추가 필드로 인해 파싱 오류 또는 결과 처리 오류가 발생하지 않도록 구현해야 합니다.

필드명	크기(byte)	설명
ResultCode	4	결과코드 (2001: 성공, 이외 실패)
ResultMsg	100	결과 메세지
ErrorCD	4	에러코드 (취소 실패 시 오류 코드 응답)
ErrorMsg	100	에러 메세지 (취소 실패 시 오류 상세 메세지 응답)
CancelAmt	12	취소 금액
MID	10	가맹점 아이디
Moid	64	가맹점 취소 주문번호
Signature	500	위변조 검증 데이터, 생성 규칙: hex(sha256(TID + MID + CancelAmt + MerchantKey))
PayMethod	10	결제수단 (신용카드: CARD, 계좌이체: BANK, 가상계좌: VBANK, 휴대폰: CELLPHONE)
TID	30	거래 아이디
CancelDate	8	취소일자 (YYYYMMDD)
CancelTime	6	취소 시간 (HHmmss)
CancelNum	8	취소번호
RemainAmt	12	부분취소 후 잔액
MallReserved	500	가맹점 여분필드 (요청 시 Data 그대로 전달)

---

5. 예시

아래 예시는 테스트 시 이해를 돕기 위해 임의로 만든 데이터로 요청 및 응답 규격을 확인하기 위한 용도입니다.
예시 데이터를 실제 API 요청에 사용하지 않도록 주의해주세요.

5.1. 요청 예시

POST /webapi/cancel_process.jsp HTTP/1.1
Host: dc1-api.nicepay.co.kr or dc2-api.nicepay.co.kr
Content-Type: application/x-www-form-urlencoded

TID=nictest00m01012608140946176906&AuthToken=NICETOKN641B9EF7DA8D8C6B57276381C21A8F54&MID=nictest00m&Amt=1000&EdiDate=20260814024618&SignData=83160ebabf6fab36722c8b4099ac327dacfac54f356db428f73898029bb0099c&NetCancel=1

5.2. 응답 예시

{
  "CouponAmt": "000000000000",
  "ClickpayCl": "",
  "MultiCardAcquAmt": "",
  "MultiPointAmt": "",
  "MultiCouponAmt": "",
  "MultiDiscountAmt": "",
  "ResultCode": "2001",
  "ResultMsg": "취소 성공",
  "ErrorCD": "0000",
  "ErrorMsg": "정상취소",
  "MsgSource": "PG",
  "CancelAmt": "000000001000",
  "MID": "nictest00m",
  "Moid": "Netcanceltest1",
  "Signature": "7b101c856bee5c673e6af489abb338b7c9f0ba5a8ec510f1c95fc69bc2dddb28",
  "PayMethod": "CARD",
  "TID": "nictest00m01012608140946176906",
  "CancelDate": "20260814",
  "CancelTime": "094618",
  "CancelNum": "00000000",
  "RemainAmt": "000000000000",
  "MallReserved": ""
}

---