헥토파이낸셜 개발자센터
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 GatewayDigital Wallets

Digital Wallet Payment

Digital wallet payment is a payment method that provides major digital wallet services such as KakaoPay, NaverPay, PAYCO, and TossPay through a unified interface.

Buyers can pay quickly with just a password or fingerprint using the payment method already registered in their digital wallet app,
which helps improve payment conversion rates.

NOTE

Key flow for digital wallet payments. Buyer selects digital wallet → Authentication in digital wallet app → Payment complete.

Supported Features by Digital Wallet Provider

KakaoPayCheckout ✓API ✓

A payment method using a card or account registered in the KakaoTalk app. Payments can be completed quickly with just a password or fingerprint authentication in the KakaoTalk app.

  • Supports recurring payments (billing). A dedicated recurring payment merchant ID is required.
NaverPayCheckout ✓API ✗

A payment method using the payment method registered in a Naver account. Payments can be made conveniently via the Naver app or web.

  • Recurring payment support is planned.
PAYCOCheckout ✓API ✗

A payment method using the payment method registered in the NHN PAYCO app.

  • Supports authentication/approval separation.
TossPayCheckout ✓API ✗

A payment method using the payment method registered in the Toss app. Payments can be authenticated and completed conveniently through the Toss app.

  • Recurring payment support is planned.

Learn About the Payment Flow

Checkout Integration

When the merchant's webpage calls the Hecto Financial checkout window, the buyer selects a digital wallet provider and proceeds with authentication in the respective app.

Buyer
Merchant
Hecto Financial
Digital Wallet Provider
11. Select digital wallet (KakaoPay/NaverPay, etc.)
1. Select digital wallet (KakaoPay/NaverPay, etc.)
22. Launch checkout (set corpPayCode)
2. Launch checkout (set corpPayCode)
33. Launch digital wallet app/web
3. Launch digital wallet app/web
44. Password/fingerprint authentication
4. Password/fingerprint authentication
55. Deliver authentication result
5. Deliver authentication result
66. Result notification (notiUrl)
6. Result notification (notiUrl)

Step Details

  1. 1Select Digital Wallet : The buyer selects a digital wallet payment method from the order form.
  2. 2Launch Checkout : The merchant calls the JavaScript SDK. The digital wallet provider is specified via corpPayCode.
  3. 3Launch Digital Wallet App : The respective digital wallet provider's app or web page opens.
  4. 4Authentication : The buyer approves the payment with a password or fingerprint.
  5. 5Deliver Result : The digital wallet provider delivers the authentication result to Hecto Financial.
  6. 6Result Notification : Hecto Financial delivers the payment result 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, payment results can be reliably received via notiUrl.

Checkout vs. Direct API

ItemCheckout IntegrationDirect API Integration
Supported ProvidersKakaoPay, NaverPay, PAYCO, TossPayKakaoPay (recurring payment)
Payment UIHecto Financial checkout → Digital wallet appNo checkout window (server-to-server communication)
Customer AuthenticationAuthentication in digital wallet appNo authentication required (uses BillKey)

Recurring Payment (KakaoPay)

KakaoPay recurring payment works by issuing a BillKey on the first payment and then executing automatic payments using only the BillKey thereafter.

Buyer
Merchant
Hecto Financial
KakaoPay
11. Sign up for recurring payment
1. Sign up for recurring payment
22. Launch checkout (recurring payment merchant ID)
2. Launch checkout (recurring payment merchant ID)
33. Authenticate in KakaoPay app
3. Authenticate in KakaoPay app
44. Payment complete + BillKey issued
4. Payment complete + BillKey issued
55. Result notification (including BillKey)
5. Result notification (including BillKey)
66. Call recurring payment API (using BillKey)
6. Call recurring payment API (using BillKey)
77. Payment result response
7. Payment result response

Step Details

  1. 1Sign Up for Recurring Payment : The buyer signs up for recurring payment (subscription).
  2. 2Launch Checkout : The merchant calls the checkout window with the dedicated recurring payment merchant ID (e.g., nxkkp_auto).
  3. 3KakaoPay Authentication : The buyer approves the payment in the KakaoPay app.
  4. 4BillKey Issued : A BillKey is issued along with the completion of the first payment.
  5. 5Save BillKey : The merchant securely stores the BillKey.
  6. 6Execute Recurring Payment : Call the recurring payment API with the BillKey at the desired time.
  7. 7Result Response : Hecto Financial responds with the payment result.
NOTE
A dedicated recurring payment merchant ID is required.KakaoPay recurring payments use a different merchant ID from regular payments. Please request a dedicated recurring payment merchant ID from your sales representative.

Pre-Integration Checklist

Before starting digital wallet payment integration, it is helpful to confirm the following items in advance.

Sandbox Environment Notes

Real charges may occur with KakaoPay in the sandbox environment. If using our test merchant ID, automatic cancellation will be processed on the same day.

Merchant ID Related

  • KakaoPay recurring payments require a dedicated recurring payment merchant ID. Please request one from your sales representative.
  • Merchant IDs differ between sandbox and production environments.

Other Notes

  • The payment methods and features supported vary by digital wallet provider. Please confirm the supported scope of each provider before integrating.

Sales / Screening Related

  • Screening may be required per digital wallet provider. Please coordinate with your sales representative.
  • Cancellation/refund policies may differ by digital wallet provider.
  • Sales inquiry:

Digital Wallet Payment Developer Documentation

💳

Digital Wallet Checkout API

Integrated digital wallet payment request (method='corp')

🔄

Recurring Payment (BillKey) API

KakaoPay recurring payment, etc.

↩️

Digital Wallet Payment Cancellation API

Cancellation request per digital wallet provider

💬

Need technical support?

Code Samples

HectoFinancial GitHub