헥토파이낸셜 개발자센터

ARS 인증 API

고객의 계좌 출금 이체 등록을 위해 ARS 인증을 수행합니다. 인증 요청 시 고객에게 전화를 걸어 생년월일 또는 인증번호를 입력받고, 확인 API를 통해 결과를 검증합니다.

ARS 인증 요청

헥토파이낸셜 서버에서 고객의 휴대폰으로 전화를 걸어 ARS 인증을 시도합니다.

API 정보

POST/v1/api/auth/ars
Content-Typeapplication/json; charset=UTF-8
테스트https://tbnpay.settlebank.co.kr/v1/api/auth/ars
운영https://npay.settlebank.co.kr/v1/api/auth/ars

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*
상점아이디
└procDivAN(2)영문+숫자, 최대 2byte
업무구분 (A0: 출금등록 / XX: ARS 시나리오)
└mchtTrdNoAN(100)영문+숫자, 최대 100byte
상점 주문번호 (한글 제외)
└mchtCustIdAN(100)영문+숫자, 최대 100byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
고객아이디
└reqDtAN(8)영문+숫자, 최대 8byte*
요청일자 (yyyyMMdd)
└reqTmAN(6)영문+숫자, 최대 6byte*
요청시간 (HH24MISS)
└bankCdAN(3)영문+숫자, 최대 3byte*
출금은행코드
└custAcntNoAN(15)영문+숫자, 최대 15byteAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
출금계좌번호 (하이픈 제외)
└mchtCustNmAN(60)영문+숫자, 최대 60byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
예금주명 (한글 3byte)
└authNoN(6)숫자, 최대 6byte*
인증번호 (생년월일(yyMMdd) 또는 임의의 숫자 6자리)
└cphoneNoAN(11)영문+숫자, 최대 11byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
휴대전화번호 (하이픈 제외)
└payerNoAN(20)영문+숫자, 최대 20byte
납부자번호 (별도 협의 필요)
└custIpAN(15)영문+숫자, 최대 15byte
고객 IP 주소
└pktHashAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA-256 해쉬값
NOTE

해쉬 생성 조합

mchtId + mchtCustId + reqDt + reqTm + cphoneNo + hashKey

응답 파라미터

└outStatCdAN(4)영문+숫자, 최대 4byte*0021
거래상태코드
0021: 성공 0031: 실패
└outRsltCdAN(4)영문+숫자, 최대 4byte*0000
거절코드
└outRsltMsgAN(300)영문+숫자, 최대 300byte*정상처리되었습니다.
결과메시지
└mchtTrdNoAN(100)영문+숫자, 최대 100byteOID201902210001
상점 주문번호
└trdNoAN(40)영문+숫자, 최대 40byte*STFP_FIRM12345678901234567890
거래번호
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?