헥토파이낸셜 개발자센터
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
ProductsMy Bank PayMy Bank Pay Overview

My Bank Pay

A simple payment service that lets you accept payments from customers directly through their bank accounts in an online store.

Customers register their bank account once and set a payment PIN, and from then on can make payments simply by entering the PIN — no complex authentication process required.

NOTE

My Bank Pay core flow. Account authentication in checkout → merchant server calls approval API → immediate withdrawal from customer's account.

Payment Methods

Key Features

Provides a simple payment experience using the customer's bank account.

  • Simple authentication: Payment can be completed with mobile phone authentication — no accredited certificate or security card required.
  • Real-time withdrawal: Funds are immediately withdrawn from the customer's account and settled to the merchant.
  • Low fees: Transaction fees are lower compared to credit card payments.
  • High payment limit: Payments can be made up to the account balance, regardless of card limits.
  • BillKey payment: BillKey enables recurring payments such as subscriptions and memberships.
Standard PaymentCheckout ✓API ✓

Authenticates the customer through the checkout on every payment and immediately withdraws funds. This is the most basic payment method — the customer completes authentication in the checkout each time.

  • Funds are withdrawn immediately after authentication in the checkout and a successful approval API call.
  • Authentication is required for every payment.
  • Works via checkout (UI) authentication + API approval.
BillKey Payment after 1st PaymentCheckout ✓API ✓

The first payment is executed at the same time as checkout authentication. A BillKey is issued in the approval response, allowing subsequent payments without a UI.

  • On the first payment, funds are withdrawn simultaneously with authentication and a BillKey is issued.
  • Subsequent payments can be made using only the BillKey without any UI.
NOTE
After BillKey issuance, the merchant must store the BillKey securely. When cancelling the BillKey, call the automatic payment key cancellation API.
BillKey Payment after Zero-Amount AuthenticationCheckout ✓API ✓

Issues a BillKey through authentication only, without an actual payment. Subsequently, payments can be made automatically on a set schedule, making it suitable for subscription and recurring payment services.

  • A zero-amount authentication in the checkout issues a BillKey without an actual payment.
  • At the desired time, call the automatic payment approval API to charge.
  • Suitable for subscription, membership, and regular delivery recurring payment services.
NOTE
Zero-amount authentication does not result in an actual charge. You must call the automatic payment approval API after BillKey issuance for the actual withdrawal to occur.

Payment Flow

Checkout Integration

The Hecto Financial checkout is invoked from the merchant's web page to authenticate the customer. Once the customer enters account information and completes identity verification, the authentication result is delivered to the merchant.

Buyer
Merchant
Hecto Financial
Bank
11. Payment request
1. Payment request
22. Invoke checkout
2. Invoke checkout
33. Display checkout
3. Display checkout
44. Enter account info / authenticate
4. Enter account info / authenticate
55. Authentication complete callback
5. Authentication complete callback

Step Details

  1. 1Payment request : The buyer requests payment at the merchant.
  2. 2Invoke checkout : The merchant invokes the Hecto Financial checkout.
  3. 3Display checkout : An account information entry screen is shown to the buyer.
  4. 4Enter account info / authenticate : The buyer enters account information and completes mobile identity verification.
  5. 5Authentication complete callback : Hecto Financial delivers the authentication result to the merchant.
The checkout only handles authentication. The payment approval API must be called within 10 minutes after authentication is complete. If this time is exceeded, the authentication information expires.

Checkout vs. Direct API

ItemCheckout IntegrationDirect API Integration
ScopeCustomer authentication (account info entry, identity verification)Payment approval, cancellation/refund, automatic payment, inquiry
Communication methodInvoke Hecto Financial checkoutServer-to-Server API call
Content-Typeapplication/x-www-form-urlencodedapplication/json; charset=UTF-8

API Integration

After checkout authentication is complete, the merchant server directly calls the Hecto Financial API to process approval, cancellation, and automatic payment.

Merchant
Hecto Financial
Bank
11. Call payment approval API
1. Call payment approval API
22. Withdrawal request
2. Withdrawal request
33. Withdrawal result
3. Withdrawal result
44. Approval result response
4. Approval result response
55. Call cancellation/refund API (if needed)
5. Call cancellation/refund API (if needed)
66. Cancellation result response
6. Cancellation result response

Step Details

  1. 1Call payment approval API : Call the approval API for a checkout-authenticated transaction.
  2. 2Withdrawal request : Hecto Financial requests a withdrawal from the customer's account.
  3. 3Withdrawal result : The bank returns the withdrawal result.
  4. 4Approval result response : Hecto Financial responds to the merchant with the approval result. (BillKey included for BillKey payments)
  5. 5Call cancellation/refund API : Call the cancellation or refund API if needed.
  6. 6Cancellation result response : Hecto Financial responds with the cancellation result.
NOTE
Key features provided via API. 1. Payment approval (standard payment / BillKey payment) 2. Cancellation/refund 3. Automatic payment key issuance / approval / cancellation 4. Transaction result inquiry 5. Network cancellation (timeout handling)

Pre-Integration Checklist

Before starting integration, we recommend reviewing the following items.

Authentication validity period

  • The payment approval API must be called within 10 minutes after payment authentication is complete. If this time is exceeded, the authentication information expires.

Timeout handling

  • If a timeout occurs when calling the payment approval API, check the result using the transaction result inquiry API.
  • If the inquiry result is successful, proceed with cancellation using the network cancellation API.

Production Environment Testing Notice

Any costs incurred from testing in the production environment are borne by the merchant. All testing must be completed in the sandbox first.

My Bank Pay Developer Documentation

🔐

Payment Authentication (UI)

Identity verification through checkout

✅

Payment Approval API

Request withdrawal approval after authentication

↩️

Cancellation/Refund API

Process payment cancellation and refunds

🔄

Automatic Payment API

Recurring payment key issuance / approval / cancellation

💬

Need technical support?

Code Samples

HectoFinancial GitHub