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