Accept a payment using local cards in South KoreaPublic preview
Enable your users to pay using locally issued cards from South Korea.
Caution
Stripe automatically presents your customers payment method options by evaluating their currency, payment method restrictions, and other parameters. We recommend that you configure your payment methods from the Stripe Dashboard using the instructions in Accept a payment.
If you want to continue manually configuring the payment methods you present to your customers with Checkout, use this guide. Otherwise, update your integration to configure payment methods in the Dashboard.
Integrating with South Korean cards lets South Korea-based customers pay using all local issuer-branded cards issued by South Korean card issuers.
When a customer makes a payment, they are redirected to the checkout page of our local processor partner to authenticate and authorize the payment. After the customer authorizes the payment, Stripe redirects them back to your site.
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.
Accept a South Korean card payment
Enable South Korean cards by making the following updates to your integration.
When creating a Checkout Session, you must do the following:
- Add
kr_
to the list ofcard payment_
.method_ types - Make sure all
line_
use theitems krw
currency.
Test your integration
While testing your Checkout integration, select Local cards 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_
to succeeded
. Failing the test payment makes the PaymentIntent switch from requires_
to requires_
. Learn more about how to test redirect-based payment methods.