헥토파이낸셜 개발자센터
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
ProductsWhite-Label PaymentsWhite-Label Payments Overview

White-Label

The White-Label service extends the Easy Cash Payment service by adding credit card as a payment method,
enabling client companies to operate an easy payment service (Easy Cash + Credit Card).

After registering as a member and setting up a PIN and payment method, customers can make easy payments using only their PIN going forward.

NOTE

White-Label core flow. Member registration and payment PIN setup via identity verification → Payment method registration → Easy payment with PIN.

Payment Methods

Hecto Financial White-Label supports two payment methods — Easy Cash Payment and Credit Card Payment — through a single unified interface.

Key Features

Easy Cash Payment and credit card can be used simultaneously and can be customized as a branded pay service. [Key Features]

  • Brand Consistency: For cases where you want to offer a payment service under your own brand / Brand pay customization supported`
  • Unified Payment: Provides multiple payment methods through a single interface
Easy Cash PaymentCheckout ✓API ✗

A payment method that registers a bank account as a payment instrument and allows easy payment using only a PIN. Since payment is directly debited from the account, there are no card processing fees.

  • Bank account-based payment with no card fees.
  • After registering an account once, payment can be made with PIN only.
  • Checkout integration handles member registration, PIN registration, account registration, and payment authentication.
Credit Card PaymentCheckout ✓API ✗

A payment method that registers a credit card as a payment instrument and allows easy card payment using only a PIN. Unlike standard card payments, there is no need to enter card information each time.

  • After registering a card once, payment can be made with PIN only.
  • Supports card payment with the same UX as Easy Cash Payment.
  • Checkout integration handles member registration, PIN registration, card registration, and payment authentication.

Payment Flow

  • After authentication is completed in the checkout, approval is requested via API.
  • Authentication and approval cannot be completed using API alone.

Checkout Integration

The merchant's web page calls the Hecto Financial White-Label checkout. The customer completes the entire process — member registration, PIN registration, payment method registration, and payment authentication — within the checkout.

Customer
Merchant
Hecto Financial
11. Service usage request
1. Service usage request
22. Call checkout (UI)
2. Call checkout (UI)
33. Display identity verification and member registration screen
3. Display identity verification and member registration screen
44. Register PIN
4. Register PIN
55. Register payment method (account/card)
5. Register payment method (account/card)
66. Payment authentication request (enter PIN)
6. Payment authentication request (enter PIN)
77. Authentication result nextUrl
7. Authentication result nextUrl

Step Details

  1. 1Service Usage Request : The customer requests a payment at the merchant.
  2. 2Call Checkout : The merchant calls the Hecto Financial White-Label checkout.
  3. 3Identity Verification and Member Registration : First-time users go through identity verification to register as a member.
  4. 4Register PIN : The customer registers a PIN to be used for payments.
  5. 5Register Payment Method : The customer registers a bank account or credit card as a payment method.
  6. 6Payment Authentication : The customer enters their PIN with the registered payment method to request payment authentication.
  7. 7Authentication Result Delivered : Hecto Financial delivers the authentication result to the merchant's nextUrl.
The checkout only processes up to authentication. After authentication is complete, the merchant server must call the Approval API to complete the actual payment. The nextUrl is for display purposes only; actual order processing logic should be based on the Approval API response.

Checkout vs. Direct API

ItemCheckout IntegrationDirect API Integration
ScopeMember registration, PIN registration, payment method registration, payment authenticationApproval request, cancellation request, transaction result inquiry
Communication MethodCall Hecto Financial checkoutServer-to-Server API call
Content-Typeapplication/x-www-form-urlencodedapplication/json

API Integration

For transactions where checkout authentication is complete, the merchant server directly calls the Hecto Financial API to process approval, cancellation, and inquiry.

Merchant
Hecto Financial
11. Call payment approval API
1. Call payment approval API
22. Approval result response
2. Approval result response
33. Call cancellation API (if needed)
3. Call cancellation API (if needed)
44. Cancellation result response
4. Cancellation result response
55. Call transaction inquiry API
5. Call transaction inquiry API
66. Inquiry result response
6. Inquiry result response

Step Details

  1. 1Payment Approval Request : Call the Approval API for transactions where checkout authentication is complete to proceed with the actual payment.
  2. 2Approval Result Received : Hecto Financial responds with the approval result.
  3. 3Payment Cancellation Request : If needed, call the Cancellation API to cancel the payment.
  4. 4Cancellation Result Received : Hecto Financial responds with the cancellation result.
  5. 5Transaction Inquiry Request : Call the Inquiry API to check the transaction status.
  6. 6Inquiry Result Received : Hecto Financial responds with the transaction status information.
NOTE
Features provided in API integration. 1. Approval request for payment authentication transactions 2. Payment cancellation request 3. Transaction result inquiry

Pre-Integration Checklist

Caution When Testing in Production Environment

Any costs incurred when testing with the merchant ID (mchtId) in the production environment are the responsibility of the merchant.

White-Label Developer Documentation

🪟

Checkout Integration

How to call the standard checkout (UI)

💳

Payment API

Payment approval API (Non-UI)

↩️

Cancellation API

Payment cancellation and refund

💬

Need technical support?

Code Samples

HectoFinancial GitHub