승인 및 취소요청 시 응답을 수신하지 못한 경우 해당 거래의 상태를 확인 가능합니다.
현재 거래의 상태에 따라 응답결과를 받을 수 있습니다. (일부 실시간 응답항목과 상이할 수 있습니다.)
HTTP POST 방식으로 호출하시기 바랍니다.
주의사항
✔ 메시지 인증값(msgAuthValue)은 거래 상태 조회에서 제공되지 않습니다.
✔ 상태조회 서비스는 전일 ~ 당일 거래만 지원합니다.
요청
URL 정보
| 테스트 | https://testpgapi.easypay.co.kr/api/trades/retrieveTransaction |
| 운영 | https://pgapi.easypay.co.kr/api/trades/retrieveTransaction |
파라미터
| 필드명 | 타입 | 최대크기 | 필수여부 | 설명 |
|---|---|---|---|---|
| mallId | String | 8 Byte | 필수 | KICC에서 부여한 상점ID |
| shopTransactionId | String | 60 Byte | 필수 | 승인/취소 요청했던 shopTransactionId |
| transactionDate | String | 8 Byte | 필수 | 승인(취소) 요청일자(yyyyMMdd) |
요청 예
{
"mallId": "T5102001",
"shopTransactionId": "qwer1234202201231516",
"transactionDate": "20240123"
}
응답
승인거래 조회일 경우 승인응답 Body를 제공합니다.
취소거래 조회일 경우 취소응답 Body를 제공합니다.