계좌 목록 조회 API
고객 아이디(mchtCustId)를 기준으로 가맹점에 등록된 모든 출금 이체 계좌 목록을 조회합니다.
계좌 목록 조회
API 정보
POST/v1/api/acnt/list
Content-Type
application/json; charset=UTF-8테스트
https://tbnpay.settlebank.co.kr/v1/api/acnt/list운영
https://npay.settlebank.co.kr/v1/api/acnt/list요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*전문정보 코드
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*상점아이디
상점아이디
└mchtCustIdAN(100)영문+숫자, 최대 100byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)고객아이디고객아이디
└bankCdAN(3)영문+숫자, 최대 3byte은행코드 (특정 은행만 조회 시 사용)
은행코드 (특정 은행만 조회 시 사용)
└reqDtAN(8)영문+숫자, 최대 8byte*요청일자 (yyyyMMdd)
요청일자 (yyyyMMdd)
└reqTmAN(6)영문+숫자, 최대 6byte*요청시간 (HH24MISS)
요청시간 (HH24MISS)
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-256 해쉬값(실시간 생성)SHA-256 해쉬값
NOTE
해쉬 생성 조합
mchtId + mchtCustId + reqDt + reqTm + hashKey
응답 파라미터
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드
0021거래상태코드
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드
0000거절코드
└outRsltMsgAN(300)영문+숫자, 최대 300byte*결과메시지
정상처리되었습니다.결과메시지
└dataCntN(4)숫자, 최대 4byte*조회된 계좌 건수
2조회된 계좌 건수
└acntRecordsObject List*계좌 내역 리스트
[{"recordBankCd":"011", "recordCustAcntNoMask":"123*******123", "recordSvcDivCd":"1"}]계좌 내역 리스트
acntRecords 상세 필드
└recordTrdDtAN(14)영문+숫자, 최대 14byte*등록일시 (yyyyMMddHHmmss)
20210820000000등록일시 (yyyyMMddHHmmss)
└recordBankCdAN(3)영문+숫자, 최대 3byte*은행코드
011은행코드
└recordCustAcntNoMaskAN(15)영문+숫자, 최대 15byte*계좌번호 (마스킹 처리, 예: 234********123)
831*******11계좌번호 (마스킹 처리, 예: 234********123)
└recordCustAcntKeyAN(50)영문+숫자, 최대 50byte*계좌번호키 (출금이체 등록된 계좌의 일련번호)
d5409fdsl3558계좌번호키 (출금이체 등록된 계좌의 일련번호)
└recordSvcDivCdN(1)숫자, 최대 1byte*계좌등록서비스구분
1계좌등록서비스구분
1: 펌뱅킹 2: 오픈뱅킹 3: 펌&오픈뱅킹└recordUnregDtAN(14)영문+숫자, 최대 14byte해지일시 (yyyyMMddHHmmss)
20210820000000해지일시 (yyyyMMddHHmmss)
