Set up a subscription with local South Korean cards

Products represent the item or service you’re selling. Prices define how much and how frequently you charge for a product. This includes how much the product costs, what currency you accept, and whether it’s a one-time or recurring charge. If you only have a few products and prices, create and manage them in the Dashboard.

This guide uses a stock photo service as an example and charges customers a 100,000 KRW monthly subscription. To model this:

1. Navigate to the Add a product page.
2. Enter a Name for the product.
3. Enter 100,000 for the price.
4. Select KRW as the currency.
5. Click Save product.

After you create the product and the price, record the price ID so you can use it in subsequent steps. The pricing page displays the ID and it looks similar to this: price_G0FvDp6vZvdwRZ.

Create a SetupIntent to save a customer’s payment method for future payments. The SetupIntent tracks the steps of this setup process.

curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d confirm=true \
  --data-urlencode return_url="https://www.stripe.com" \
  -d usage=off_session \
  -d customer=cus_ODQluYFNl44ODI \
  -d "payment_method_data[type]"=kr_card \
  -d "payment_method_types[]"=kr_card \
  -d "mandate_data[customer_acceptance][type]"=online \
  -d "mandate_data[customer_acceptance][online][ip_address]"="127.0.0.0" \
  -d "mandate_data[customer_acceptance][online][user_agent]"=device

The SetupIntent object contains a unique client_secret. Pass it to Stripe.js on the client side to redirect your customer to our local processor’s checkout page and authorize the mandate.

Create a subscription that has a price and a customer. Set the value of the default_payment_method parameter to the PaymentMethod ID from the SetupIntent response.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]"={{PRICE_ID}} \
  -d default_payment_method={{PAYMENT_METHOD_ID}} \
  -d off_session=true

Creating subscriptions automatically charges customers due to the preset default payment method. After a successful payment, the status in the Stripe Dashboard changes to Active. The price that you previously set up determines the amount for future billings. Learn how to create a subscription with a free trial period.

Confirm a payment with PaymentIntents using the PaymentIntent ID from the Subscriptions response. Add the PaymentIntent ID to the URL path and set the value of the payment_method_types parameter to kr_card:

curl https://api.stripe.com/v1/payment_intents/:id/confirm \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  --data-urlencode return_url="https://www.stripe.com" \
  -d "payment_method_data[]"=type \
  -d "payment_method_data[]"=kr_card

The PaymentIntent response includes the status requires_action. That status indicates that the customer must complete the payment with the payment method they selected to complete the PaymentIntent. After a successful payment, the subscription becomes active and saves the payment method as the default payment method.