Configurer un abonnement avec des cartes sud-coréennes locales

Les produits correspondent aux articles ou services que vous vendez. Les tarifs définissent le montant et la fréquence des paiements facturés pour un produit. Le tarif prend en compte la valeur du produit, la devise que vous acceptez et s’il s’agit d’un paiement ponctuel ou récurrent. Si vous n’avez que quelques produits et tarifs, créez-les et gérez-les dans le Dashboard.

Ce guide prend comme exemple un service de banque d’images qui débite ses clients d’un montant de 100,000 KRW pour un abonnement mensuel. Pour modéliser ceci :

1. Go to the Products page and click Create product.
2. Saisissez un Nom pour le produit. Vous pouvez éventuellement ajouter une Description et télécharger une image du produit.
3. Select a Product tax code. Learn more about product tax codes.
4. Sélectionnez Récurrent. Saisissez ensuite pour le prix et sélectionnez comme devise.
5. Choose whether to Include tax in price. You can either use the default value from your tax settings or set the value manually. In this example, select Auto.
6. Pour Période de facturation, sélectionnez Mensuel.
7. Click More pricing options. Then select Flat rate as the pricing model for this example. Learn more about flat rate and other pricing models.
8. Add an internal Price description and Lookup key to organize, query, and update specific prices in the future.
9. Cliquez sur Suivant. Cliquez ensuite sur Ajouter un produit.

Après avoir créé le produit et le tarif, enregistrez l’ID de tarif de manière à pouvoir l’utiliser dans les étapes ultérieures. La page des tarifs affiche l’ID dont le format est similaire à ce qui suit : price_G0FvDp6vZvdwRZ.

Créez un objet SetupIntent pour enregistrer le moyen de paiement d’un client en vue de paiements futurs. Le SetupIntent permet de suivre les étapes de ce processus de configuration.

curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

L’objet SetupIntent contient un client_secret unique. Transmettez-le à Stripe.js côté client pour rediriger votre client vers la page de paiement de notre prestataire local et autoriser le mandat.

Créez un abonnement avec un tarif et un client. Définissez la valeur du paramètre default_payment_method sur l’ID de PaymentMethod contenu dans la réponse du SetupIntent.

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

Dans le cadre d’un abonnement, le client est débité automatiquement selon le moyen de paiement préconfiguré par défaut. Lorsqu’un paiement aboutit, son état dans le Dashboard Stripe bascule sur Actif. Le tarif que vous avez configuré détermine le montant des prochaines factures. Découvrez comment créer un abonnement avec une période d’essai gratuit.

Confirmez un paiement avec l’API PaymentIntents à l’aide de l’ID de PaymentIntent contenu dans la réponse de l’objet Subscription. Ajoutez l’ID de PaymentIntent à l’URL et définissez la valeur du paramètre payment_method_types sur kr_card :

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

La réponse du PaymentIntent inclut l’état requires_action. Cet état indique que pour finaliser le PaymentIntent, les clients doivent effectuer le paiement avec le moyen de paiement qu’ils ont sélectionné. Une fois le paiement abouti, l’abonnement devient actif et le moyen de paiement est enregistré comme moyen de paiement par défaut.