ARS Verification API
Performs ARS (automated voice) verification for direct debit enrollment. When a verification request is made, an automated call is placed to the customer's mobile phone. The customer enters their date of birth or a verification code via keypad, and the result is validated through the confirmation API.
ARS Verification Request
Hecto Financial places an automated call to the customer's mobile phone to initiate ARS verification.
API Information
POST/v1/api/auth/ars
Content-Type
application/json; charset=UTF-8테스트
https://tbnpay.settlebank.co.kr/v1/api/auth/ars운영
https://npay.settlebank.co.kr/v1/api/auth/arsRequest Parameters
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)Alphanumeric, up to 50 bytes*Message type code. Fixed value.
Message type code. Fixed value.
*Fixed value
└mchtIdAN(8)Alphanumeric, up to 8 bytes*Merchant ID.
Merchant ID.
└procDivAN(2)Alphanumeric, up to 2 bytesBusiness type (A0: Direct debit enrollment / XX: ARS scenario).
Business type (A0: Direct debit enrollment / XX: ARS scenario).
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytesMerchant order number (no Korean characters).
Merchant order number (no Korean characters).
└mchtCustIdAN(100)Alphanumeric, up to 100 bytes*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)Customer ID. AES-256 encrypted.Customer ID. AES-256 encrypted.
└reqDtAN(8)Alphanumeric, up to 8 bytes*Request date (yyyyMMdd).
Request date (yyyyMMdd).
└reqTmAN(6)Alphanumeric, up to 6 bytes*Request time (HH24MISS).
Request time (HH24MISS).
└bankCdAN(3)Alphanumeric, up to 3 bytes*Debit bank code.
Debit bank code.
└custAcntNoAN(15)Alphanumeric, up to 15 bytes
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)Debit account number (no hyphens). AES-256 encrypted.Debit account number (no hyphens). AES-256 encrypted.
└mchtCustNmAN(60)Alphanumeric, up to 60 bytes*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)Account holder name (Korean: 3 bytes per character). AES-256 encrypted.Account holder name (Korean: 3 bytes per character). AES-256 encrypted.
└authNoN(6)Numeric, up to 6 bytes*Verification code (date of birth in yyMMdd format, or any 6-digit number).
Verification code (date of birth in yyMMdd format, or any 6-digit number).
└cphoneNoAN(11)Alphanumeric, up to 11 bytes*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)Mobile phone number (no hyphens). AES-256 encrypted.Mobile phone number (no hyphens). AES-256 encrypted.
└payerNoAN(20)Alphanumeric, up to 20 bytesPayer number. Requires separate agreement.
Payer number. Requires separate agreement.
└custIpAN(15)Alphanumeric, up to 15 bytesCustomer IP address.
Customer IP address.
└pktHashAN(200)Alphanumeric, up to 200 bytes*
SHA-256SHA-256 HMAC signature.(실시간 생성)SHA-256 HMAC signature.
NOTE
Signature Composition
mchtId + mchtCustId + reqDt + reqTm + cphoneNo + hashKey
Response Parameters
└outStatCdAN(4)Alphanumeric, up to 4 bytes*Transaction status code.
0021Transaction status code.
0021: Success 0031: Failure└outRsltCdAN(4)Alphanumeric, up to 4 bytes*Decline code.
0000Decline code.
└outRsltMsgAN(300)Alphanumeric, up to 300 bytes*Result message.
Processed successfully.Result message.
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytesMerchant order number.
OID201902210001Merchant order number.
└trdNoAN(40)Alphanumeric, up to 40 bytes*Transaction reference number.
STFP_FIRM12345678901234567890Transaction reference number.
Need technical support?
Code Samples
HectoFinancial GitHub