Accept installment card paymentsVersion bêta privée

Installments (分割払い) are a type of credit card payment in Japan that allows customers to split purchases over multiple billing statements. You receive the full amount as with standard card payments, and the customer’s card company provides credit and collects the funds over time.

Some restrictions apply to which transactions and cards can use installments. Review the compatibility requirements.

You can enable installments across a variety of Stripe products. Choose the instructions below that match your implementation.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "line_items[0][price]"={{PRICE_ID}} \
  -d "line_items[0][quantity]"=3 \
  -d mode=payment \
  -d "payment_method_options[card][installments][enabled]"=true

Test the integration

You can use the following cards to test your integration.

Testing successful payments

Testing payment failures

Sometimes a card might be a valid Japan-issued credit card, but the card issuer decides to decline the transaction. You can use the card number below to retrieve a list of supported installment plans, but the transaction fails with a card_declined error.