계좌목록조회 API
고객의 계좌목록 정보를 요청합니다.
고객의 아이디로 등록(출금이체등록) 된 계좌의 목록을 조회 할 수 있습니다.
API 정보
POST/v1/api/acnt/list
Content-Type
application/json테스트
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)상점에서 보내주는 고유 고객아이디 혹은 Unique 한 Key상점에서 보내주는 고유 고객아이디 혹은 Unique 한 Key
└bankCdAN(3)영문+숫자, 최대 3byte은행코드
은행코드
*3자리 은행코드
└reqDtAN(8)영문+숫자, 최대 8byte*요청일자
요청일자
*yyyyMMdd
└reqTmAN(6)영문+숫자, 최대 6byte*요청시간
요청시간
*HH24MISS
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)SHA256 방식으로 생성한 해쉬값
*상점아이디 + 고객아이디(평문) + 요청일자 + 요청시간 + 인증키
요청 전문 해쉬 코드
| 항목 | 조합 필드 |
|---|---|
| pktHash 값 | 상점아이디 + 고객아이디(평문) + 요청일자 + 요청시간 + 인증키 |
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드 (성공/실패)
거래상태코드 (성공/실패)
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드
거절코드
*거절코드 테이블 참조
└outRsltMsgAN(300)영문+숫자, 최대 300byte*결과메시지
정상처리되었습니다.결과메시지
*오류가 발생시 오류에 대한 메시지 전달
└dataCntN(4)숫자, 최대 4byte*계좌건수
10계좌건수
*거래내역이 존재하는 경우 거래건수
└acntRecords<object>*계좌내역
계좌내역
└--recordTrdDtAN(14)영문+숫자, 최대 14byte*등록일시
20210820000000등록일시
*yyyyMMddhhmmss
└--recordBankCdAN(3)영문+숫자, 최대 3byte*은행코드
004은행코드
└--recordCustAcntNoAN(15)영문+숫자, 최대 15byte*계좌번호
831*******11계좌번호
*계좌번호 마스킹 처리 (예: 234********123)
└--recordCustAcntKeyAN(50)영문+숫자, 최대 50byte*계좌번호키
d5409fdsl3558계좌번호키
*출금이체 등록된 계좌의 일련번호
└--recordSvcDivCdN(4)숫자, 최대 4byte*계좌등록서비스구분
계좌등록서비스구분
1: 펌뱅킹 2: 오픈뱅킹 3: 펌&오픈뱅킹*출금이체 등록 된 서비스
└--recordUnregDtAN(14)영문+숫자, 최대 14byte해지일시
20210820000000해지일시
*yyyyMMddhhmmss
요청 예시
{
"hdInfo": "SPAY_LA00_1.0",
"mchtId": "midtest",
"mchtCustId": "AES암호화된고객아이디",
"bankCd": "004",
"reqDt": "20191231",
"reqTm": "120000",
"pktHash": "해시값"
}
응답 예시
{
"outStatCd": "0021",
"outRsltCd": "0000",
"outRsltMsg": "정상처리되었습니다.",
"dataCnt": "1",
"acntRecords": [
{
"recordTrdDt": "20210820000000",
"recordBankCd": "004",
"recordCustAcntNo": "831*******11",
"recordCustAcntKey": "d5409fdsl3558",
"recordSvcDivCd": "2",
"recordUnregDt": "20210820000000"
}
]
}
