금융결제원 출금이체정보 해지 조회 API
고객이 금융기관(은행 등) 또는 금융결제원(PAYINFO)에서 계좌해지를 신청한 경우, 헥토파이낸셜 간편결제 시스템에서 고객 계좌의 출금이체 해지를 신청일 기준으로 익영업일(오전 11시 이전) 진행합니다.
해지 후 가맹점의 고객 출금이체 정보와 정합성을 맞추기 위해 해당 API를 제공합니다. 오전 11시 이후부터 해당일에 출금이체 해지된 계좌정보 목록을 확인할 수 있습니다.
도메인 주의
이 API는 다른 API와 다르게 nspay 도메인을 사용합니다.
API 정보
POST/v1/api/acnt/isttunreg/list
Content-Type
application/json; charset=UTF-8테스트
https://tb-nspay.settlebank.co.kr/v1/api/acnt/isttunreg/list운영
https://nspay.settlebank.co.kr/v1/api/acnt/isttunreg/list요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*전문정보 코드
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*상점아이디
상점아이디
└unregDtAN(8)영문+숫자, 최대 8byte*해지일자 (고객 계좌의 출금이체가 해지된 일자, yyyyMMdd)
해지일자 (고객 계좌의 출금이체가 해지된 일자, yyyyMMdd)
└reqDtAN(8)영문+숫자, 최대 8byte*요청일자 (yyyyMMdd)
요청일자 (yyyyMMdd)
└reqTmAN(6)영문+숫자, 최대 6byte*요청시간 (HH24MISS)
요청시간 (HH24MISS)
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-256 해쉬값(실시간 생성)SHA-256 해쉬값
NOTE
해쉬 생성 조합
mchtId + unregDt + reqDt + reqTm + hashKey
응답 파라미터
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드
0021거래상태코드
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드
0000거절코드
└outRsltMsgAN(300)영문+숫자, 최대 300byte*결과메시지
정상처리 되었습니다.결과메시지
└unregDtAN(14)영문+숫자, 최대 14byte*해지일자 (yyyyMMdd)
20210830해지일자 (yyyyMMdd)
└dataCntN(4)숫자, 최대 4byte*해지계좌건수
10해지계좌건수
└unregAcntRecordsObject List*해지계좌목록
[{"recordMchtCustId":"kimhecto", "recordBankCd":"004"}]해지계좌목록
unregAcntRecords 상세 필드
└recordMchtCustIdAN(100)영문+숫자, 최대 100byte*고객아이디
kimhecto고객아이디
└recordBankCdAN(3)영문+숫자, 최대 3byte*은행코드
004은행코드
└recordCustAcntNoAN(15)영문+숫자, 최대 15byte*계좌번호 (마스킹)
234******123계좌번호 (마스킹)
└recordCustAcntKeyAN(50)영문+숫자, 최대 50byte*계좌번호키 (출금이체 등록된 계좌의 일련번호)
d894kjd93kd9계좌번호키 (출금이체 등록된 계좌의 일련번호)
└recordUnregDtmAN(14)영문+숫자, 최대 14byte*해지일시 (yyyyMMddhhmmss)
20210831080000해지일시 (yyyyMMddhhmmss)
└recordUnregOculsttN(1)숫자, 최대 1byte*해지발생기관
1해지발생기관
1: 금융회사 2: 이용기관해지 3: 인터넷지로 해지접수 4: 통합관리시스템└recordUnregDivCdAN(1)영문+숫자, 최대 1byte*해지구분
0해지구분
0: 고객요청 1: 금융회사 임의해지(자동이체 등) 2: 금융회사 계좌변경 9: 기타 N: 동의자료 부재 (공백): 해지발생기관 값이 3일 경우
