| Doc. No. | A6S4V1 | ||
|---|---|---|---|
| API Title | 거래내역 > 거래내역 확인 | ||
| API Description | 회원이 보유한 카드의 결제내역을 조회합니다. | ||
| Protocol | HTTP | Interface Type | SYNC |
| HTTP METHOD | POST | Request URL | /api/v1/transaction/card/single |
| Data Encryption | Request : NO / Response : NO | ||
| Field | Type | Length | MOC | Description | ||
|---|---|---|---|---|---|---|
| userId | NUMBER | 1~999999999999 | MANDATORY | 회원 ID - 회원가입 시 부여되는 회원의 고유 ID입니다. |
||
| par | STRING | 27 | MANDATORY | 조회할 카드의 카드의 PAN(Primary Account Number)을 대체하는 번호 | ||
| nrNumber | STRING | 18 | MANDATORY | 거래 고유번호 - Network Reference Number |
||
| Field | Type | Length | MOC | Description | ||
|---|---|---|---|---|---|---|
| transactionInfo | OBJECT | MANDATORY | 거래 내역 목록 | |||
| └ trType | STRING | 2 | MANDATORY | 거래 타입 - 00 : 결제 - 01 : 충전 - 02 : 환불 - 03 : 이관(송금) |
||
| └ authCancelType | STRING | 1~6 | MANDATORY | 승인/취소 타입 - AUTH : 승인 - CANCEL : 취소 |
||
| └ approvalDateTime | STRING | 14 | MANDATORY | 거래 승인 시간 - 형식 : yyyyMMddHHmmss |
||
| └ approvalCode | STRING | 6 | MANDATORY | 거래 승인코드 | ||
| └ orgAmount | NUMBER | 0~999999999999 | MANDATORY | 결제 요청 금액 | ||
| └ trAmount | NUMBER | 0~999999999999 | MANDATORY | 카드 잔액 결제 금액 - 서버할인 금액 또는 쿠폰이나 포인트 사용 등으로 인한 할인금액을 제외한 카드잔액에서 결제된 금액입니다. |
||
| └ discountAmount | NUMBER | 0~999999999999 | MANDATORY | 서버할인 금액 - 쿠폰 사용 등으로 할인 받은 총 금액입니다. |
||
| └ usedPointAmount | NUMBER | 0~999999999999 | MANDATORY | 포인트 결제 금액 - 결제 시 사용된 포인트 금액입니다. |
||
| └ savedPointAmount | NUMBER | 0~999999999999 | MANDATORY | 거래를 통해 적립된 포인트 금액 | ||
| └ balanceBefore | NUMBER | 0~999999999999 | MANDATORY | 거래 이전 잔액 | ||
| └ balanceAfter | NUMBER | 0~999999999999 | MANDATORY | 거래 후 잔액 | ||
| └ merchantName | STRING | 1~255 | MANDATORY | 결제 가맹점명 | ||
| └ nrNumber | STRING | 18 | MANDATORY | 거래 고유번호 - Network Reference Number |
||
| └ reversalStatus | STRING | 2 | MANDATORY | 거래 취소 여부 - 00 : 취소 처리된 거래 - 01 : 취소 되지 않은 거래 - 02 : 부분 취소된 거래 |
||
| response | OBJECT | MANDATORY | 응답 결과 값 | |||
| └ code | STRING | 1~7 | MANDATORY | 응답 결과 코드 | ||
| └ description | STRING | 1~255 | MANDATORY | 응답 결과 상세 설명 | ||
| HTTP Status | Error code | Message | Description |
|---|---|---|---|
| 프로토콜 항목의 "공통 Error Message 정보"에서 추가 확인 바랍니다. | |||