Member Registration UI Integration API

Member registration for the SecurePay Prepaid service is handled through Hecto Financial's standard screen.

Overview

The member registration screen performs the following steps:

Mobile phone identity verification
Payment PIN setup
Account holder name verification and account ownership confirmation
KYC completion (CDD/EDD)

Screen URL

GET/identity

Content-Typeapplication/json

테스트https://tb-mps.hectofinancial.co.kr/identity

운영https://mps.hectofinancial.co.kr/identity

Integration Process

Customer

Merchant

Hecto Financial

11. Member registration request

1. Member registration request

22. Member information inquiry API (enrollment check)

2. Member information inquiry API (enrollment check)

33. Non-enrolled response

3. Non-enrolled response

44. Call member registration screen (GET /identity)

4. Call member registration screen (GET /identity)

55. Identity verification / account verification / KYC

5. Identity verification / account verification / KYC

66. Registration complete (returnUrl, custNo issued)

6. Registration complete (returnUrl, custNo issued)

Pre-Call Requirements

Enrollment Check Required

Before calling the member registration screen, you must verify the user's enrollment status using the Member Information Inquiry API. If an already-enrolled member enters the screen, error code 103 is returned.

Request Parameters

타입 표기법

N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자

예: AN(10) = 영문+숫자, 최대 10byte

└mIdAN(20)Alphanumeric, up to 20 bytes*Unique merchant ID assigned by Hecto Financial.

Unique merchant ID assigned by Hecto Financial.

└mCustIdAN(50)Alphanumeric, up to 50 bytes*Merchant customer ID.

Merchant customer ID.

└ciEncAN(500)Alphanumeric, up to 500 bytes*AES-256AES-256/ECB/PKCS5Padding + Base64Customer CI (connection information).

Customer CI (connection information).

*Encryption algorithm: AES-256/ECB/PKCS5Padding. Encoding: Base64.

└returnUrlAN(200)Alphanumeric, up to 200 bytes*Return URL to redirect the customer after the registration process completes, is cancelled, or encounters an error.

Return URL to redirect the customer after the registration process completes, is cancelled, or encounters an error.

NOTE

Parameter Encoding

All parameters must be URI-encoded (encodeURIComponent) before passing.

returnUrl Response Parameters

When member registration completes, the following parameters are passed to the returnUrl.

타입 표기법

N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자

예: AN(10) = 영문+숫자, 최대 10byte

└statusAN(10)Alphanumeric, up to 10 bytes*Prepaid service status.success

Prepaid service status.

success: Successful processing (registration complete) canceled: User cancelled mid-process failure: Error occurred

└errorCodeN(3)Numeric, up to 3 bytesError code (passed when status is failure).103

Error code (passed when status is failure).

101: Identity verification page error 102: Unregistered merchant access 103: Already-enrolled member access 104: Re-registration not allowed (within 30 days of cancellation) 105: Identity confirmation page error 106: CI value mismatch 107: Individual member registration not allowed for this merchant

└custNoAN(20)Alphanumeric, up to 20 bytesUnique prepaid member number assigned by Hecto Financial (passed when status is success).2400001605

Unique prepaid member number assigned by Hecto Financial (passed when status is success).

*Used for subsequent API calls.

└pktHashAN(64)Alphanumeric, up to 64 bytes*SHA-256 tamper-detection hash value.a2d6d597d55d7c9b...

SHA-256 tamper-detection hash value.

pktHash Signature Composition (varies by status)

status	Signature composition
`success`	`mId + mCustId + "success" + hashKey`
`canceled`	`mId + mCustId + "canceled" + hashKey`
`failure`	`mId + mCustId + "failure" + errorCode + hashKey`

Important Notes

The member registration screen is provided as a responsive design for both mobile and PC.
Supported identity verification methods: mobile phone authentication, joint certificate.
Registration may be restricted depending on KYC review results.
The account will be locked after 5 consecutive incorrect PIN entries.

Need technical support?

Code Samples

HectoFinancial GitHub