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-8Sandbox
https://tbnpay.settlebank.co.kr/v1/api/auth/arsProduction
https://npay.settlebank.co.kr/v1/api/auth/arsRequest Parameters
Type Notation
NNumericAAlphabeticHKoreanANAlphanumericAHNAlphanumeric + Koreane.g. AN(10) = alphanumeric, up to 10 bytes
└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 + Base64Customer 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 + Base64Debit 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 + Base64Account 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 + Base64Mobile 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.(auto-generated)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.
