API 문서
전체 API
서비스
거래내역 확인동기
버전: v1
버전: v1
/api/v1/transaction/card
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
transactionInfo
array of objects
필수
거래 내역 목록
transactionInfo_item
object
옵션
trType
string
필수
길이 : 2
거래 타입
- 00 : 결제
- 01 : 충전
- 02 : 환불
- 03 : 이관(송금)
입력하지 않은 경우, 전체 거래 타입을 조회합니다.
authCancelType
string
필수
최소 : 1 , 최대 : 6
승인/취소 타입
- AUTH : 승인
- CANCEL : 취소
approvalDateTime
string
필수
길이 : 14
거래 승인 시간
- 형식 : yyyyMMddHHmmss
approvalCode
string
필수
최소 : 1 , 최대 : 6
거래 승인코드
orgAmount
number
필수
최소 : 0 , 최대 : 1000000000
결제 요청 금액
trAmount
number
필수
최소 : 0 , 최대 : 1000000000
카드 잔액 결제 금액
- 서버할인 금액 또는 쿠폰이나 포인트 사용 등으로 인한 할인금액을 제외한 카드잔액에서 결제된 금액입니다.
discountAmount
number
필수
최소 : 0 , 최대 : 1000000000
서버할인 금액
- 쿠폰 사용 등으로 할인 받은 총 금액입니다.
usedPointAmount
number
필수
최소 : 0 , 최대 : 1000000000
포인트 결제 금액
- 결제 시 사용된 포인트 금액입니다.
savedPointAmount
number
필수
최소 : 0 , 최대 : 1000000000
거래를 통해 적립된 포인트 금액
balanceBefore
number
필수
최소 : 0 , 최대 : 1000000000
거래 이전 잔액
balanceAfter
number
필수
최소 : 0 , 최대 : 1000000000
거래 후 잔액
merchantName
string
필수
최소 : 1 , 최대 : 255
결제 가맹점명
nrNumber
string
필수
길이 : 18
거래 고유번호
- Network Reference Number
bizLicenseNo
string
옵션
길이 : 10
사업자 등록 번호
rcgType
string
옵션
길이 : 2
충전 거래 타입
- 03: 신용카드
- 04: 간편충전(은행계좌)
- 05: 자동충전(은행계좌)
- 06: 자동충전 등록 후 간편충전(은행계좌)
- 31: 충전취소 불가형 - 무승인 자동충전(정산파트)
- 32: 결제 시 자동충전
- 33: 결제 시 자동충전 시, 결제 실패 후, 자동 충전
- 60: 시스템 어드민 충전
- 68: 신용카드 자동 충전
rechargeCancelable
number
옵션
값 : 1
충전 취소 가능 여부
- 0 : 충전 취소 불가능
- 1 : 충전 취소 가능
cashReciptInfo
object
옵션
현금 영수증 발급 정보
approvalNo
string
필수
길이 : 9
현금 영수증 승인번호
- 현금 영수증 취소 시, 취소승인번호
isuStCd
string
필수
길이 : 1
현금영수증의 발급상태
- 0 : 미발급
- 1 : 승인
- 2 : 취소
approvalDate
string
필수
길이 : 8
현금 영수증 거래일자
pageResponse
object
필수
페이징 응답 정보
page
number
필수
최소 : 0 , 최대 : 1000
페이징 인덱스
- 기본값 = 0
totalPages
number
필수
최소 : 0 , 최대 : 1000
전체 페이지 수
numberOfElements
number
필수
최소 : 0 , 최대 : 10000
전체 목록 개수
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success.
설명
성공
400
에러 코드
000_001
메시지
Unkown Reason.
설명
외부 service와 통신 실패
400
에러 코드
000_002
메시지
Invalid input parameter.
설명
입력 파라미터 오류
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.