결제 취소

승인된 결제 내역을 취소하는 API입니다. 원거래 승인 시 발급된 정보(VAN 거래일련번호 또는 가맹점 거래일련번호)를 사용하여 취소를 요청합니다.

주의사항

응답 대기시간 초과(Read Timeout) 및 네트워크 오류로 응답을 받지 못한 경우, 실제로는 취소가 처리되었을 수 있습니다. 이때 반드시 망취소(Net-Cancel) API를 통해 상태를 확인해야 합니다.

요청

요청 URL
POST https://{API 도메인}/smpy/kiccpay/reqCancel
Content-type: application/json; charset=utf-8

파라미터

필드명	타입	길이	필수여부	설명
tid	String	10Byte	✅	KICC 단말기 ID
svcId	String	10Byte	✅	KICC 간편결제 서비스 ID
bizrNo	String	10Byte	✅	가맹점 사업자번호
mercTrxNo	String	40Byte	✅	가맹점 거래일련번호 (20Byte 권장)
wcc	String	1Byte	✅	취소키 유형 `T`: VAN 거래일련번호 `G`: 가맹점 거래일련번호
cndTrxNo	String	20Byte	✅	취소용 거래일련번호 `wcc`="T"일 때: 원승인 vanTrxNo `wcc`="G"일 때: 원승인 mercTrxNo
alotMonth	String	2Byte	✅	할부기간 (Default: "00" - 일시불)
trxAmt	Number		✅	전체 결제금액
vatAmt	Number		✅	부가세
svcAmt	Number		✅	봉사료
tranDt	String	8Byte	✅	가맹점 전송일자 (yyyyMMdd)
tranTm	String	6Byte	✅	가맹점 전송시각 (HH24MISS)
orgAprvDt	String	8Byte	✅	원승인일자 (yyyyMMdd)
orgAprvNo	String	10Byte	✅	원승인번호

요청 예시
{
    "tid": "{KICC 단말기 ID}",
    "svcId": "{KICC 간편결제 서비스 ID}",
    "bizrNo": "1234567890",
    "mercTrxNo": "CANCEL_20231225_0001",
    "wcc": "G",
    "cndTrxNo": "ORD_20231225_0001",
    "alotMonth": "00",
    "trxAmt": 10000,
    "vatAmt": 909,
    "svcAmt": 0,
    "tranDt": "20231226",
    "tranTm": "100000",
    "orgAprvDt": "20231225",
    "orgAprvNo": "12345678"
}

응답

파라미터

필드명	타입	길이	필수여부	설명
respCd	String	4Byte	✅	결과코드 (정상 : “0000”)
respMsg	String	128Byte	✅	결과 메시지
tid	String	10Byte	✅	KICC 단말기 ID
svcId	String	10Byte	✅	KICC 간편결제 서비스 ID
bizrNo	String	10Byte	✅	가맹점 사업자번호
mercTrxNo	String	20Byte	✅	가맹점 거래일련번호
trxDt	String	8Byte	✅	VAN 처리요청일자
trxTm	String	6Byte	✅	VAN 처리요청시각
issFmCd	String	4Byte	✅	발급사 코드 (카드코드 참조)
issFmNm	String	20Byte	✅	발급사 명
purchFmCd	String	4Byte	✅	매입사 코드 (카드코드 참조)
purchFmNm	String	20Byte	✅	매입사 명
joShopNo	String	15Byte	✅	카드사 가맹점번호
cndDt	String	8Byte	✅	카드사 취소일자
cndTm	String	6Byte	✅	카드사 취소시각
aprvNo	String	10Byte	✅	신용카드사 승인번호
vanTrxNo	String	12Byte	✅	VAN 거래 고유번호
cardConfirmNo	String	40Byte	✅	마스킹된 카드번호 (Masked Card No)

응답 예시
{
    "respCd": "0000",
    "respMsg": "취소 성공",
    "tid": "T123456789",
    "svcId": "SVC_SIMPLE",
    "bizrNo": "1234567890",
    "mercTrxNo": "CANCEL_20231225_0001",
    "trxDt": "20231226",
    "trxTm": "100001",
    "issFmCd": "06",
    "issFmNm": "국민카드",
    "purchFmCd": "06",
    "purchFmNm": "국민카드",
    "joShopNo": "1234567890",
    "cndDt": "20231226",
    "cndTm": "100002",
    "aprvNo": "12345678",
    "vanTrxNo": "V12345678902",
    "cardConfirmNo": "1234-56**-****-1234"
}

요청​

파라미터​

응답​

파라미터​

요청

파라미터

응답

파라미터