거래내역 확인

API Description

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

Request Parameter

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

Response Parameter

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 응답 결과 상세 설명

Response Code

HTTP Status Error code Message Description
프로토콜 항목의 "공통 Error Message 정보"에서 추가 확인 바랍니다.

Example

Request


            

Response