거래상태 조회
승인 및 취소요청 시 응답을 수신하지 못한 경우 해당 거래의 상태 확인하는 API 입니다.
주의사항
- 메시지 인증값(msgAuthValue)은 거래 상태 조회에서 제공되지 않습니다.
- 상태조회 서비스는 전일 ~ 당일 거래만 지원합니다.
요청
요청 URL
POST https://{API 도메인}/api/trades/retrieveTransaction
Content-type: application/json; charset=utf-8
파라미터
| 필드명 | 타입 | 길이 | 필수여부 | 설명 |
|---|---|---|---|---|
| mallId | String | 8Byte | ✅ | KICC에서 부여한 상점ID |
| shopTransactionId | String | 60Byte | ✅ | 결제 승인/취소 요청 시 사용했던 상점 거래고유번호 |
| transactionDate | String | 8Byte | ✅ | 승인(취소) 요청일자(yyyyMMdd) |
요청 예시
{
"mallId": "{상점ID}",
"shopTransactionId": "{상점 거래고유번호}",
"transactionDate": "{요청 일자}"
}