Accept a payment using Kakao Pay in South Korea

Learn how to accept payments from Kakao Pay users.

Checkout

Direct API

Integrating with Kakao Pay enables South Korea-based customers to pay using this popular local payment method.

When a customer makes a payment, we redirect them to our local processor partner to authenticate and authorize the payment. After the customer authorizes the payment, Stripe redirects them back to your site.

Regional considerations Singapore

Kakao Pay isn’t available in Singapore.

Determine compatibility

A Checkout Session must satisfy all of the following conditions to support South Korean payment methods:

Prices for all line items must be expressed in Korean won (currency code krw ).
The minimum amount accepted is 100 KRW. There is no maximum limit for card passthrough transactions, while the maximum amount that a customer can top up to their Kakao Pay account as stored value is 2,000,000 KRW.

Accept a Kakao Pay payment

Enable Kakao Pay by making the following updates to your integration.

When creating a Checkout Session, you must do the following:

Enable Kakao Pay in your Dashboard. Stripe automatically displays Kakao Pay to eligible customers using dynamic payment methods . If you currently specify payment _ method _ types , see the migration guide .
Make sure all line _ items use the krw currency.
Provide the customer’s email address.

Command Line

Select a language

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

.NET

No results

Test your integration with Kakao Pay

While testing your Checkout integration, select Kakao Pay and click Pay. This redirects you to a Stripe-hosted page where you have the choice to authorize or fail the payment. If you authorize the payment, the PaymentIntent switches from requires_action to succeeded. Failing the test payment makes the PaymentIntent switch from requires_action to requires_payment_method. Learn more about how to test redirect-based payment methods.