헥토파이낸셜 개발자센터

ARS Verification Confirmation API

Checks whether the customer answered the ARS call and completed verification following the ARS verification request.

ARS Verification Confirmation

Retrieves the result of the ARS verification attempt.

API Information

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

Request Parameters

└hdInfoAN(50)Alphanumeric, up to 50 bytes*
Message type code. Fixed value.
*Fixed value
└mchtIdAN(8)Alphanumeric, up to 8 bytes*
Merchant ID.
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytes
Merchant order number.
└mchtCustIdAN(100)Alphanumeric, up to 100 bytes*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
Customer ID. AES-256 encrypted.
└reqDtAN(8)Alphanumeric, up to 8 bytes*
Request date.
└reqTmAN(6)Alphanumeric, up to 6 bytes*
Request time.
└trdNoAN(50)Alphanumeric, up to 50 bytes*
Transaction reference number received in the ARS verification request response.
└custIpAN(15)Alphanumeric, up to 15 bytes
Customer IP address.
└pktHashAN(200)Alphanumeric, up to 200 bytes*SHA-256(실시간 생성)
SHA-256 HMAC signature.
NOTE

Signature Composition

mchtId + mchtCustId + reqDt + reqTm + trdNo + hashKey

Response Parameters

└outStatCdAN(4)Alphanumeric, up to 4 bytes*0021
Transaction status code.
0021: Success 0031: Failure 0092: No transaction found 0000: In progress
└outRsltCdAN(4)Alphanumeric, up to 4 bytes*0000
Decline code.
└outRsltMsgAN(300)Alphanumeric, up to 300 bytes*Processed successfully.
Result message.
└retCdAN(3)Alphanumeric, up to 3 bytes*0000
Detailed error code. 0000: Success, 000: In progress, other values indicate failure.
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytesOID201902210001
Merchant order number.
└trdNoAN(40)Alphanumeric, up to 40 bytes*STFP_FIRM12345678901234567890
Hecto Financial transaction reference number.
💬

Need technical support?