Configurer un abonnement avec Kakao Pay

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]"=kakao_pay \
  -d "payment_method_types[]"=kakao_pay \
  -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, une clé unique que vous devez transmettre à Stripe.js côté client afin de rediriger votre acheteur vers Kakao Pay 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

Quand vous créez un abonnement, le moyen de paiement débité est automatiquement le moyen de paiement par défaut du client. 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 kakao_pay :

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[]"=kakao_pay

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