정기결제 거래내역 조회 API
정기결제 거래 내역을 조회합니다.
정기결제 거래내역 조회
일정 기간 동안의 정기결제 거래 내역을 조회합니다.
API 정보
POST/v1/api/regular/translist
Content-Type
application/json; charset=UTF-8테스트
https://tbnpay.settlebank.co.kr/v1/api/regular/translist운영
https://npay.settlebank.co.kr/v1/api/regular/translist요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*전문정보 코드
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*상점아이디
상점아이디
└mchtCustIdAN(100)영문+숫자, 최대 100byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)고객아이디고객아이디
└reqDtAN(8)영문+숫자, 최대 8byte*요청일자 (yyyyMMdd)
요청일자 (yyyyMMdd)
└reqTmAN(6)영문+숫자, 최대 6byte*요청시간 (HH24MISS)
요청시간 (HH24MISS)
└rglChrgKeyAN(32)영문+숫자, 최대 32byte*정기결제용으로 생성된 유니크한 키
정기결제용으로 생성된 유니크한 키
└useStDtAN(8)영문+숫자, 최대 8byte*조회시작일 (yyyyMMdd)
조회시작일 (yyyyMMdd)
*조회 기간은 최대 1년 (365일)
└useEdDtAN(8)영문+숫자, 최대 8byte*조회종료일 (yyyyMMdd)
조회종료일 (yyyyMMdd)
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-256 해쉬값(실시간 생성)SHA-256 해쉬값
NOTE
해쉬 생성 조합
mchtId + mchtCustId + reqDt + reqTm + rglChrgKey + hashKey
응답 파라미터
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드
0021거래상태코드
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드
0000거절코드
*ST08: 이미 등록된 계좌일 경우 등록된 계좌 정보 전달
└outRsltMsgAN(300)영문+숫자, 최대 300byte*결과메시지
정상처리되었습니다.결과메시지
└dataCntN(4)숫자, 최대 4byte*거래내역이 존재하는 경우 거래건수
10거래내역이 존재하는 경우 거래건수
└trRecordsObject List*거래내역 리스트
[{"recordTrdDt":"20210830080000", "recordTrdAmt":"50000"}]거래내역 리스트
trRecords 상세 필드
└recordTrdDtAN(14)영문+숫자, 최대 14byte거래일자 (yyyyMMddhhmmss)
20210830080000거래일자 (yyyyMMddhhmmss)
└recordBankCdAN(3)영문+숫자, 최대 3byte은행코드
011은행코드
└recordBankNmAN(45)영문+숫자, 최대 45byte은행명 (한글 3byte)
국민은행은행명 (한글 3byte)
└recordCustAcntNoAN(15)영문+숫자, 최대 15byte계좌번호 (마스킹 처리)
1234***********6546계좌번호 (마스킹 처리)
└recordRglChrgKeyAN(32)영문+숫자, 최대 32byte정기결제용으로 생성된 유니크한 키
정기결제용으로 생성된 유니크한 키
└recordTrdNoAN(50)영문+숫자, 최대 50byte거래번호
STFP_FIRM1234576789890거래번호
└recordMchtTrdNoAN(100)영문+숫자, 최대 100byte상점 주문번호
OID2021083021343상점 주문번호
*한글 제외
└recordTrdAmtN(13)숫자, 최대 13byte거래금액
50000거래금액
└recordUseOrdN(13)숫자, 최대 13byte이용회차
1이용회차
└recordOutStatCdAN(4)영문+숫자, 최대 4byte거래상태코드
0021거래상태코드
0021: 성공 0031: 실패└recordOutRsltCdAN(4)영문+숫자, 최대 4byte거래결과코드
0000거래결과코드
└recordOutRsltMsgAN(200)영문+숫자, 최대 200byte거래결과메시지
성공거래결과메시지
