Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous

Accepter les paiements d'abonnement avec PayTo

En savoir plus sur la création et la facturation d'un abonnement avec PayTo.

Suivez ce guide pour configurer un abonnement avec PayTo 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 tarif
Dashboard

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 AUD 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éer une session Checkout
Côté serveur

votre client doit vous autoriser à utiliser son compte bancaire pour les paiements futurs via stripe checkout. cela vous permet d’accepter les paiements payto. ajoutez un bouton de paiement à votre site Web qui appelle un endpoint côté serveur pour créer une session Checkout.

index.html
<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.

Limitez le montant de vos mandats en définissant un amount dans les payement_method_options, car plusieurs banques rejettent systématiquement les mandats sans montant spécifié.

Command Line
cURL
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode success_url="https://example.com/success" \
  -d "line_items[0][price]"={{RECURRING_PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=payto \
  -d "payment_method_options[payto][mandate_options][amount]"=1500 \
  -d mode=subscription

Tester votre intégration

Testez votre intégration PayTo avec vos clés API de test en utilisant les différents PayID de test et les coordonnées bancaires ci-dessous. Chaque combinaison donne lieu à un scénario différent auquel votre intégration pourrait être confrontée en mode production.

PayIDDescription
{any_prefix}+succeed@{any_domain}L’état de la PaymentIntent passe de requires_action à processing au bout de 10 secondes, puis à succeeded après 5 secondes supplémentaires. Le mandat passe alors à l’état active.
{any_prefix}+decline@{any_domain}L’état de la PaymentIntent passe de requires_action à requires_payment_method au bout de 10 secondes. Stripe renvoie le code d’erreur payment_method_provider_decline avec le code de refus de paiement invalid_authorization. Le mandat passe alors à l’état inactive.
{any_prefix}+expire@{any_domain}L’état de la PaymentIntent passe de requires_action à requires_payment_method au bout de 10 secondes. Stripe renvoie le code d’erreur payment_method_provider_decline avec le code de refus de paiement generic_decline. Le mandat passe alors à l’état inactive.
{any_prefix}+insufficient_funds@{any_domain}L’état de la PaymentIntent passe de requires_action à processing au bout de 10 secondes, puis à requires_payment_method après 5 secondes supplémentaires. Stripe renvoie le code d’erreur payment_method_provider_decline avec le code de refus de paiement insufficient_funds. Le mandat passe alors à l’état inactive.
{any_prefix}+revoke@{any_domain}L’état de la PaymentIntent passe de requires_action à processing au bout de 10 secondes, puis à succeeded après 5 secondes supplémentaires. Le mandat est d’abord à l’état active, puis passe à l’état inactive au bout d’une minute.
{any_prefix}+agreement_type_not_supported@{any_domain}L’état de la PaymentIntent passe de requires_action à requires_payment_method au bout de 10 secondes. Stripe renvoie le code d’erreur payment_method_provider_decline. Le mandat passe alors à l’état inactive.