빌키 삭제

발급받은 빌키를 더 이상 사용하지 않을 경우 해당 빌키를 삭제하는 API 입니다.

요청

요청 URL

POST https://{API 도메인}/api/trades/removeBatchKey
Content-type: application/json; charset=utf-8

참고

API 멱등성 지원 대상 (API 멱등성 참조)

파라미터

필드명	타입	길이	필수여부	설명
mallId	String	8Byte	✅	KICC에서 부여한 상점ID
shopTransactionId	String	60Byte	✅	상점 거래고유번호 (API 멱등성 키)
batchKey	String	40Byte	✅	삭제할 빌키
removeReqDate	String	8Byte	✅	삭제 요청일자(yyyyMMdd)

요청 예시

{  
    "mallId": "T5102001",     
    "shopTransactionId": "{API 멱등성 키}",    
    "batchKey": "{삭제할 빌키}",
    "removeReqDate": "{삭제 요청 일자}"
}

응답

파라미터

필드명	타입	길이	설명
resCd	String	4Byte	결과코드(정상 : “0000”)
resMsg	String	1000Byte	결과 메시지
shopTransactionId	String	60Byte	삭제요청 시 전송한 값 그대로 사용
mallId	String	8Byte	KICC에서 부여한 상점ID
removeReqDate	String	8Byte	삭제요청 시 전송한 값 그대로 사용

응답 예시

{
   "resCd": "0000",
   "resMsg": "정상",
   "mallId": "{요청한 상점ID}",   
   "shopTransactionId": "{요청한 API 멱등성 키}",
   "removeReqDate": "{삭제 요청 일자}"
}