헥토파이낸셜 개발자센터
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
ProductsPayment Gateway010 Virtual Account

010 Virtual Account

A virtual account service that uses mobile phone numbers (010-0000-0000) as virtual account numbers.
Deposit convenience is improved by using a phone number instead of a complex account number.

NOTE

Key flow for 010 Virtual Account. Step 1: Account issuance request → 010 virtual account issued. Step 2: Buyer makes deposit → Receive deposit notification → Complete order. Just like general virtual accounts, deposit notification processing via notiUrl is mandatory.

Learn About Payment Methods

Hecto Financial offers virtual account payment methods you can choose based on your service needs.

010 Virtual AccountCheckout ✓API ✓

A virtual account service that uses the customer's mobile phone number (010-0000-0000) as the virtual account number. This improves deposit convenience by using a phone number instead of a complex account number.

  • Virtual accounts are issued through K-Bank (089) using the customer's own mobile phone number.
  • Customers can make deposits easily using their own phone number as the account number.
General Virtual AccountCheckout ✓API ✓

A virtual account service issued in the standard account number format of each bank. Supports multiple banks and is suitable for general bank transfer (without account) deposits.

  • Supports multiple banks, allowing customers to choose their preferred bank.
NOTE
Please refer to the separate documentation for General Virtual Accounts.

Learn About the Payment Flow

Checkout Integration

The customer enters payment information in the checkout window and receives a 010 virtual account. When a deposit to the issued account (phone number) is completed, the deposit result is delivered via notiUrl.

Buyer
Merchant
Hecto Financial
K-Bank
11. Payment request from order form
1. Payment request from order form
22. Launch checkout (JS SDK)
2. Launch checkout (JS SDK)
33. Display checkout window
3. Display checkout window
44. Enter payment information
4. Enter payment information
55. Request 010 virtual account issuance
5. Request 010 virtual account issuance
66. Issue 010 virtual account
6. Issue 010 virtual account
77. Deliver virtual account info (notiUrl)
7. Deliver virtual account info (notiUrl)

Step Details

  1. 1Payment Request : The buyer selects a payment method from the order form and clicks the "Pay" button.
  2. 2Launch Checkout : The merchant calls the Hecto Financial JavaScript SDK (SETTLE_PG.pay) to open the checkout window.
  3. 3Display Checkout : The 010 virtual account payment information entry screen is displayed to the buyer.
  4. 4Enter Information : The buyer enters the required payment information.
  5. 5Account Issuance Request : Hecto Financial requests K-Bank to issue the 010 virtual account.
  6. 6Account Issued : K-Bank issues a virtual account in the format 010-XXXX-XXXX.
  7. 7Deliver Result : Hecto Financial delivers the virtual account information to the merchant server's notiUrl.
Make sure to implement notiUrl.notiUrl is required for checkout integration. Even if the buyer closes the checkout window midway or exits the browser, the account issuance result and deposit result can be reliably received via notiUrl. Since nextUrl is only for display purposes, actual order processing logic must be handled in notiUrl.

Checkout vs. Direct API

ItemCheckout IntegrationDirect API Integration
Issuance MethodAutomatically handled in checkoutMerchant calls API directly
Payment UIHecto Financial checkout windowMerchant's own design possible
notiUrlRequiredRequired (to receive deposit notifications)

API Integration

This method issues 010 virtual accounts by directly calling the issuance API. The result is received via notiUrl when the deposit is completed.

Buyer
Merchant
Hecto Financial
K-Bank
11. Payment request
1. Payment request
22. Call issuance API
2. Call issuance API
33. Request 010 virtual account issuance
3. Request 010 virtual account issuance
44. Issue 010 virtual account
4. Issue 010 virtual account
55. API response (account info)
5. API response (account info)
66. Deposit instructions (010-XXXX-XXXX)
6. Deposit instructions (010-XXXX-XXXX)

Step Details

  1. 1Payment Request : The buyer requests payment from the merchant.
  2. 2API Call : The merchant server calls the Hecto Financial issuance API.
  3. 3Account Issuance Request : Hecto Financial requests K-Bank to issue the 010 virtual account.
  4. 4Account Issued : K-Bank issues a virtual account in the format 010-XXXX-XXXX.
  5. 5API Response : Hecto Financial responds to the merchant server with the virtual account information.
  6. 6Deposit Instructions : The merchant provides the buyer with the 010 virtual account number and deposit instructions.
Implementing notiUrl is also required for API integration. Because virtual account issuance and deposit are separate processes, notiUrl must be implemented to know when a deposit is completed. The API response only includes the issuance result; actual deposit notifications are delivered via notiUrl.

Differences from General Virtual Accounts

CategoryGeneral Virtual Account010 Virtual Account
Account Number FormatBank-specific account number format (numeric string)010-XXXX-XXXX (phone number)
Partner BankMultiple banks supportedK-Bank (089) only
Customer ConvenienceComplex account number entrySimple deposit using phone number
Account MemorabilityDifficultEasy — it's the customer's own number
Use CaseGeneral bank transfer depositsServices where deposit convenience is important

Pre-Integration Checklist

Before starting 010 Virtual Account integration, it is helpful to confirm the following items in advance.

NOTE

K-Bank exclusive service. 010 virtual accounts can only be issued through K-Bank (bank code: 089). If you need virtual accounts from other banks, please use the General Virtual Account service.

Other Notes

  • The phone number does not need to match the actual customer's number. However, using the customer's own number is recommended for deposit convenience.
  • If a deposit is not made within the expiration period, the account is automatically expired. No separate notification is sent upon expiration, so merchants must implement their own expiration handling logic.
  • Partial deposits are not supported. The full amount set must be deposited at once.
  • In the sandbox environment, you can simulate deposits using the deposit test API.

Sales / Screening Related

  • You will need to consult with a sales representative to use the 010 Virtual Account service.
  • Sales inquiry:

010 Virtual Account API Documentation

🪟

Checkout (UI)

Virtual account issuance via checkout window

🏦

Issuance API

010 Virtual account issuance

❌

Issuance Cancellation

Cancel virtual account before deposit

↩️

Refund

Refund a completed deposit

💬

Need technical support?

Code Samples

HectoFinancial GitHub