은행 목록 조회 API
가맹점에서 사용 가능한 은행 목록을 조회합니다. 결제창 UI 구성 시 활용할 수 있습니다.
API 정보
POST/v1/api/bank/list
Content-Type
application/json; charset=UTF-8테스트
https://tbnpay.settlebank.co.kr/v1/api/bank/list운영
https://npay.settlebank.co.kr/v1/api/bank/list요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*전문정보 코드
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*상점아이디
상점아이디
└reqDtAN(8)영문+숫자, 최대 8byte*요청일자
요청일자
└reqTmAN(6)영문+숫자, 최대 6byte*요청시간
요청시간
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-256 해쉬값(실시간 생성)SHA-256 해쉬값
NOTE
해쉬 생성 조합
mchtId + reqDt + reqTm + hashKey
응답 파라미터
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드
0021거래상태코드
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드
0000거절코드
└outRsltMsgAN(300)영문+숫자, 최대 300byte*결과메시지
정상처리되었습니다.결과메시지
└dataCntN(4)숫자, 최대 4byte*은행 개수
10은행 개수
└bankRecordsObject List*은행 내역 리스트
[{"recordBankCd":"004", "recordBankNm":"국민은행", "recordUseYn":"Y"}]은행 내역 리스트
bankRecords 상세 필드
└recordBankCdAN(3)영문+숫자, 최대 3byte*은행코드
004은행코드
└recordBankNmAN(45)영문+숫자, 최대 45byte*은행명 (한글 3byte)
국민은행은행명 (한글 3byte)
└recordBankOrdN(2)숫자, 최대 2byte*UI에서 표시될 순서
1UI에서 표시될 순서
└recordUseYnA(1)영문, 최대 1byte*은행 오픈 및 사용가능 여부
Y은행 오픈 및 사용가능 여부
Y: 사용가능 N: 사용불가
