Configurer un abonnement avec TWINT
Découvrez comment créer et facturer un abonnement avec TWINT.
Utilisez ce guide pour configurer un abonnement avec TWINT comme moyen de paiement.
Vous pouvez utiliser l’API Checkout pour créer et confirmer un abonnement avec une page de paiement préconfigurée.
Créez un produit et un tarifDashboard
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 15 CHF pour un abonnement mensuel. Pour modéliser ceci :
- Go to the Products page and click Create product.
- Saisissez un Nom pour le produit. Vous pouvez éventuellement ajouter une Description et télécharger une image du produit.
- Select a Product tax code. Learn more about product tax codes.
- Sélectionnez Récurrent. Saisissez ensuite pour le prix et sélectionnez comme devise.
- 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.
- Pour Période de facturation, sélectionnez Mensuel.
- Click More pricing options. Then select Flat rate as the pricing model for this example. Learn more about flat rate and other pricing models.
- Add an internal Price description and Lookup key to organize, query, and update specific prices in the future.
- 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_.
Créer une session CheckoutCôté serveur
Votre client doit vous autoriser à utiliser son compte TWINT pour les futurs paiements via Stripe Checkout. Cela vous permet d’accepter les paiements TWINT.
Ajoutez à votre site internet un bouton de paiement qui appelle un endpoint côté serveur afin de créer une session Checkout.
<html> <head> <title>Checkout</title> </head> <body> <form action="/create-checkout-session" method="POST"> <button type="submit">Checkout</button> </form> </body> </html>
créez une session Checkout en mode subscription pour collecter les informations requises. après avoir créé la session Checkout, redirigez votre client vers l’url renvoyée dans la réponse.
curl https://api.stripe.com/v1/checkout/sessions \ -u ":" \ --data-urlencode "success_url=https://example.com/success" \ -d "line_items[0][price]={{RECURRING_PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=subscriptionsk_test_VePHdqKTYQjKNInc7u56JBrQ
Tester votre intégrationCôté serveur
Testez votre intégration TWINT avec vos clés API de test en affichant la page de redirection. Si vous autorisez le mandat sur la page de redirection, la SetupIntent passe de l’état requires_ à succeeded. Si vous refusez le mandat sur la page de redirection, la SetupIntent passe de requires_ à requires_.