등록취소
예약등록된 거래를 취소하는 API 입니다.
주의사항
- 결제가 완료된 거래는 취소가 불가하며, 취소된 거래의 결제링크를 클릭해도 결제가 진행되지 않습니다.
- 승인 거래는 등록 취소가 불가 합니다. 또한 결제 승인취소(환불)가 아닙니다.
요청
요청 URL
POST https://{API 도메인}/directapi/trades/directSmsUrlPayCancel
Content-type: application/json; charset=utf-8
파라미터
| 필드명 | 타입 | 길이 | 필수여부 | 설명 |
|---|---|---|---|---|
| mallId | String | 8Byte | ✅ | KICC에서 부여한 상점ID |
| reviseTypeCode | String | 2Byte | ✅ | 변경구분 “10” 고정 |
| reviseSubTypeCode | String | 2Byte | ✅ | 변경세부구분 "30" 고정 |
| pgCno | String | 20Byte | ✅ | 원 거래 PG 거래고유번호 |
| clientId | String | 32Byte | ✅ | 요청자 ID 가맹점 관리자 로그인용 ID |
요청 예시
{
"mallId": "{상점ID}",
"reviseTypeCode": "10",
"reviseSubTypeCode": "30",
"pgCno": "{PG 거래고유번호}",
"clientId": "{요청자 ID}",
"msgAuthValue": "{메시지 인증값}
}
응답
파라미터
| 필드명 | 타입 | 길이 | 설명 |
|---|---|---|---|
| resCd | String | 4Byte | 결과코드(정상 : “0000”) |
| resMsg | String | 1000Byte | 결과 메시지 |
| pgCno | String | 20Byte | 등록 PG 거래고유번호 |
응답 예시
{
"resCd": "0000",
"resMsg": "정상처리",
"pgCno": "{PG 거래고유번호}"
}