헥토파이낸셜 개발자센터

Account Ownership Verification Confirmation API

Validates the verification code confirmed by the customer.

Account Ownership Verification Confirmation (2-Step, Step 2)

Validates the verification code confirmed by the customer.

API Information

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

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 transaction number. Must match the value sent in the request step.
└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.
└authNoAN(12)Alphanumeric, up to 12 bytes*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
Verification code (excluding sender name). AES-256 encrypted.
└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 + reqDt + reqTm + mchtTrdNo + hashKey

Response Parameters

└outStatCdAN(4)Alphanumeric, up to 4 bytes*0021
Transaction status code.
0021: Success 0031: Failure
└outRsltCdAN(4)Alphanumeric, up to 4 bytes*0000
Decline code.
└outRsltMsgAN(300)Alphanumeric, up to 300 bytes*Success
Result message.
└mchtCustIdAN(100)Alphanumeric, up to 100 bytes*AES-256AES-256/ECB/PKCS5Paddingkimhecto
Customer ID. AES-256 encrypted.
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└trdNoAN(40)Alphanumeric, up to 40 bytes*STFP_FIRM12345678901234567890
Transaction reference number.
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytes*OID201902210001
Merchant transaction number.
💬

Need technical support?