Accept a payment using local cards in South Korea

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.

Enable South Korean cards by making the following updates to your integration.

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

• Add kr_card to the list of payment_method_types.
• Make sure all line_items use the krw currency.

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'kr_card'],
  line_items: [{
    price_data: {
      currency: 'usd',
      # To accept `kr_card`, all line items must have currency: krw
      currency: 'krw',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

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_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.