헥토파이낸셜 개발자센터
ProductsProducts
Payment Gateway
Cards, bank & digital wallets
My Bank Pay
Open banking debit
Easy Cash Payment
Stored-account payments
White-Label Payments
White-label checkout
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Integrate with LLMs
MCP server & AI chatbot
API & SDKAPI & SDK
Payment Gateway
Cards, bank & digital wallets
My Bank Pay
Open banking debit
Easy Cash Payment
Stored-account payments
White-Label Payments
White-label checkout
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
블로그Blog
Service Status
Payment Gateway
My Bank Pay
Easy Cash Payment
White-Label Payments
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Integrate with LLMs
MCP 서버 및 AI 챗봇
Payment Gateway
My Bank Pay
Easy Cash Payment
White-Label Payments
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Blog
Technical blog & news
Service Status
Incidents and scheduled maintenance
Getting StartedCredit CardVirtual Account010 Virtual AccountBank TransferMobile PaymentGift CardPoint DamoaDigital Wallets
My Bank Pay
Firm BankingOpen Banking
White-Label Payments
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Getting StartedCredit CardVirtual Account010 Virtual AccountBank TransferMobile PaymentGift CardPoint DamoaDigital Wallets
My Bank Pay
Firm BankingOpen Banking
White-Label Payments
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
ProductsPrepaid WalletPrepaid Wallet Overview

What is Prepaid Wallet?

Prepaid Wallet is a platform that makes it easy to build a prepaid money service
where customers can make payments using pre-charged balance.

In general, operating a prepaid service requires a license for "prepaid electronic payment instrument issuance" under the Electronic Financial Transactions Act.

By using Hecto Financial's Prepaid Wallet,
you can quickly introduce a brand-exclusive prepaid money and points service without the need to obtain a complex financial license.

If you are planning to build easy payment features such as brand-exclusive points, money, prepaid cards, gift cards, or rewards, please review the information below.

NOTE

Prepaid Wallet Service Features ⸰ Launch prepaid services quickly ⸰ 100% safe management of prepaid funds ⸰ Brand money that drives customer return visits

Prepaid Wallet Features

Prepaid Wallet provides an integrated set of features needed for prepaid services, including balance top-up, usage, gifting, points earn/use, and balance management.

Balance Top-UpCheckout ✗API ✓

Prepaid balance can be topped up using a variety of payment methods, including credit cards and bank transfers. Auto top-up functionality provides a convenient payment experience.

Balance UsageCheckout ✗API ✓

Charged balance can be used to make easy payments at both online and offline merchants.

Balance GiftCheckout ✗API ✓

Prepaid members can easily gift or send balance to each other. Can be used for events, promotions, and more.

Points Earn/UseCheckout ✗API ✓

Points earning and usage features allow you to operate membership programs, events, and reward programs.

Balance Management/WithdrawalCheckout ✗API ✓

Provides balance management features including balance inquiry, transaction history, and account withdrawal.

Service Flow

  • Member registration and profile management require UI integration.
  • Core features such as top-up, usage, and inquiry are handled via API integration.

UI Integration

Member registration and profile management are handled by calling the UI screens provided by Hecto Financial. Complex procedures such as identity verification, account authentication, and KYC are handled within the screen, reducing the development burden on merchants.

Customer
Merchant
Hecto Financial
11. Member registration request
1. Member registration request
22. Member info inquiry API (check registration status)
2. Member info inquiry API (check registration status)
33. Unregistered member response
3. Unregistered member response
44. Call member registration screen
4. Call member registration screen
55. Display identity/account verification and KYC screens
5. Display identity/account verification and KYC screens
66. Registration complete (custNo issued)
6. Registration complete (custNo issued)

Step Details

  1. 1Member Registration Request : The customer requests to sign up for the Prepaid Wallet service at the merchant.
  2. 2Check Registration Status : The merchant calls the member info inquiry API to check if the customer is already registered.
  3. 3Unregistered Member Response : Hecto Financial responds that the customer is not yet registered.
  4. 4Call Registration Screen : The merchant calls the Hecto Financial member registration screen.
  5. 5Identity/Account Verification and KYC : The customer completes the identity verification, account authentication, and KYC procedures.
  6. 6Registration Complete : Hecto Financial issues a customer number (custNo) to the merchant.
Must verify registration status before calling the member registration screen. You must confirm registration status via the member info inquiry API before calling the screen. If an already-registered member enters the registration screen, error code (103) will be returned.

Checkout vs. Direct API

ItemCheckout IntegrationDirect API Integration
ScopeMember registration, profile managementTop-up, usage, gifting, points, balance inquiry, withdrawal
Communication MethodCall Hecto Financial UI screenServer-to-Server API call
RequiredUI integration required for registration/profileAPI integration required for core features

API Integration

Core features such as prepaid balance top-up, usage, withdrawal, and inquiry are provided as Server-to-Server APIs. The merchant server directly calls the Hecto Financial API for processing.

Customer
Merchant
Hecto Financial
11. Payment request
1. Payment request
22. Balance inquiry API
2. Balance inquiry API
33. Balance response
3. Balance response
44. Usage API (PIN authentication)
4. Usage API (PIN authentication)
55. Usage completion response
5. Usage completion response
66. Payment complete
6. Payment complete

Step Details

  1. 1Payment Request : The customer requests to pay with prepaid balance at the merchant.
  2. 2Balance Inquiry : The merchant calls the balance inquiry API to check if sufficient balance is available.
  3. 3Balance Response : Hecto Financial responds with the current balance information.
  4. 4Call Usage API : The merchant calls the usage API and processes the payment through PIN authentication.
  5. 5Usage Completion Response : Hecto Financial responds with the usage (payment) result.
  6. 6Payment Complete : The merchant notifies the customer that the payment is complete.
NOTE
Key features provided via API. Balance inquiry, balance usage/usage cancellation, balance top-up, balance gifting, points earn/use/reclaim, per-charge balance inquiry, balance option changes, withdrawal, and more.

Pre-Integration Checklist

Before starting integration, please review the following items in advance.

Must Verify Member Registration Status

Before calling the member registration or profile page, you must always check registration status via the member info inquiry API.

UI Integration Checklist

  • Before entering the registration page, confirm the customer is not yet registered via the member info inquiry API. Error code (103) will be returned if an already-registered member enters the registration page.
  • The profile page will return an error if accessed by an unregistered user. Always verify registration status before calling it.
  • If the payment PIN is entered incorrectly 5 or more times, the account will be locked. The account can be unlocked via the payment PIN reset menu on the profile page.
  • In the test environment, real transactions do not occur. For 1-KRW authentication, please request that your merchant ID be registered as an exception with the company.

Other Notes

  • Test server deployments may occur between 1:00 PM and 2:00 PM on business days.
  • TLS 1.2 or higher is recommended.

Prepaid Wallet Developer Documentation

📱

Top-Up API

API for topping up (crediting) money or points to a member.

💰

Transaction History Inquiry API

Transaction list inquiry, transaction detail inquiry, and other inquiry APIs

💳

Charge/Withdrawal API

Top-up, cancellation, withdrawal, and other APIs

💬

Need technical support?

Code Samples

HectoFinancial GitHub