본문으로 건너뛰기

거래상태 조회

승인 및 취소요청 시 응답을 수신하지 못한 경우 해당 거래의 상태 확인하는 API 입니다.

주의사항

상태조회 서비스는 당일거래만 지원합니다.

요청​

요청 URL
POST https://{API 도메인}/appcardpay/v1/history.do
Content-type: application/json; charset=euc-kr

파라미터​

필드명타입길이필수여부설명
vanTidString8Byte✅승인 또는 취소 요청한 VAN 터미널 ID
shopTransactionIdString60Byte✅결제 승인/취소 요청 시 사용했던 상점 거래고유번호
reqDateString8Byte✅승인/취소 요청일자(yyyyMMdd)
요청 예시
{  
    "vanTid": "{VAN 터미널 ID}", 
    "shopTransactionId": "{상점 거래고유번호}", 
    "reqDate": "{요청 일자}"
}

응답​

결제 승인거래 조회 응답

응답 예시
{  
  // 신용카드 결제 승인응답
  "resCd": "0000",
  "resMsg": "결제 정상",
  "vanTid": "{요청한 상점ID}",
  "pgCno": "{PG 거래고유번호}",
  "shopTransactionId": "{요청한 API 멱등성 키}",
  "shopOrderNo": "{상점 주문번호}",
  "amount": 51004,
  "transactionDate": "20210326090200",
  "accepterId": "{가맹점번호}",
  "cardCode": "029",   
  "paymentInfo": {
     "payMethodTypeCode": "11",
     "approvalNo": "00017177",
     "vanSerial": "50123011010326090200",
     "cardInfo": {
        "cardNo": "45184211******81",
        "issuerCode": "029",         
        "acquirerCode": "029",         
        "installmentMonth": "00"         
    }
  }
}