Introduction
KakaoPay is a mobile-first digital wallet deeply integrated into KakaoTalk, South Korea’s dominant messaging app. Integrating KakaoPay with Payrails allows you to offer a seamless, familiar checkout experience to South Korean customers while leveraging our platform to route the payment via Checkout.com as a Payment Service Provider (PSP). KakaoPay uses a redirect-based payment flow. When a customer selects KakaoPay at checkout, they are redirected to KakaoPay’s app or web interface to authenticate and confirm their payment, then redirected back to your website or app upon completion. KakaoPay is a single-use payment method where customers must authenticate each payment. This guide explains the process of integrating KakaoPay into your app or website using Payrails.Pre-requisites
Before you start accepting KakaoPay payments with Payrails, there are a few requirements you must meet:Ways to integrate KakaoPay
Payrails SDK
Server-to-server integration
Parse KakaoPay from lookup response
Pass KakaoPay payment method in request to authorize payment with Payrails
Note on amountsKRW is a zero-decimal currency—amounts should be provided as whole numbers (for example,
10000 for ₩10,000). Do not include decimal places.KakaoPay is a redirect-based, single-use payment method. After calling the authorize endpoint, the customer will be redirected to KakaoPay to authenticate and confirm the payment. Once the payment is confirmed, the customer will be redirected back to the
returnInfo.success URL. Make sure to provide valid returnInfo URLs in your authorization request.Handle the redirect response
Supported currencies
KakaoPay via Checkout.com supports the following presentment currencies:- KRW - Won
- HKD - Hong Kong Dollar
- SGD - Singapore Dollar
Supported regions / countries
Customer regions
KakaoPay is available to customers based in:- South Korea 🇰🇷
Merchant regions
Merchants based in the following countries can accept KakaoPay payments via Checkout.com:- Hong Kong 🇭🇰
- Singapore (Beta) 🇸🇬
- 🇪🇺 European Economic Area (Beta)
- United Kingdom (Beta) 🇬🇧