Mise en place de paiements PayTo futurs

Comment configurer des paiements PayTo futurs.

PayTo permet aux clients australiens d’authentifier les mandats de paiement PayTo ponctuels et récurrents dans leur application bancaire. Pour payer avec PayTo, les clients reçoivent une notification de demande de mandat en attente, donnent leur autorisation après lecture des conditions du mandat, puis retournent à votre application.

La mise en place d’un mandat PayTo pour les paiements futurs vous permet d’obtenir dès maintenant l’autorisation du client pour prélever les paiements futurs. Les clients peuvent consulter, gérer, suspendre et annuler leurs mandats PayTo dans leurs applications bancaires.

Mise en garde

Stripe doesn’t support modification or pausing of PayTo mandates by customers. If a customer attempts to pause or modify a mandate, we cancel the mandate and send you a mandate.updated webhook. After receiving the webhook, you can reach out to your customer to find out why they adjusted their mandate, as well as set up a new mandate.

Checkout

Elements

API Direct

Mettez en place un paiement

Remarque

Ce guide s’appuie sur le module de base Configuration des paiements futurs de l’intégration Checkout.

pour activer payto comme moyen de paiement, créez une nouvelle session Checkout :

Fixez le paramètre mode sur setup.
Spécifiez les conditions du mandat que vous souhaitez que votre client accepte en utilisant les moyens de paiement disponibles.
Ajouter payto à la liste de payment_method_types.

Stripe prend en charge différents types de mandats, avec des contrôles sur le montant, la durée, la fréquence et l’objet du mandat. Spécifiez des conditions de mandat qui correspondent autant que possible à vos exigences. Les clients voient ces conditions précises au moment de l’autorisation, donc leur exactitude peut améliorer votre taux de conversion.

Stripe détermine le purpose par défaut, en fonction de votre code de catégorie commerçant (MCC). Remplacez ce champ en utilisant l’une des valeurs valides, si la valeur par défaut ne reflète pas fidèlement l’objet de l’accord. Vous pouvez vérifier la valeur par défaut dans l’objet mandat, lorsque vous ne spécifiez pas l’objectif.

Débiter ultérieurement le moyen de paiement PayTo

Avant de pouvoir facturer votre client, recherchez l’ID du mandat, l’ID du client et l’ID du mode de paiement en récupérant la SetupIntent à l’aide de son ID dans la session Checkout.

Consultez les ID voulus dans la réponse ci-dessous.

{
  // ...
  "customer": "cus_PW6rQWRGAaBD7z",  // <---- Here is the customer
  "mandate": "mandate_1Ok6ZrA8DuEjWaGw2nrO9xeS", // <---- Here is the mandate
  "metadata": {},
  "next_action": null,
  "on_behalf_of": null,
  "payment_method": "pm_1Ok4l9A8DuEjWaGwhB4SGrWh", // <---- Here is the payment method
  "payment_method_configuration_details": null,
  "payment_method_options": {
    "payto": {
      "mandate_options": {
        "amount": 150000,
        "amount_type": "maximum",
        "start_date": "2026-12-25",
        "end_date": "2036-12-25",
        "payment_schedule": "annual",
        "payments_per_period": 13,
        "purpose": "mortgage",
      }
    }
  },
  "payment_method_types": [
    "payto"
  ],
  "single_use_mandate": null,
  "status": "succeeded",
  "usage": "off_session"
  // ...
}

Créez une intention de paiement{ % /glossary %} avec les identifiants PaymentMethod, Mandate et Customer.

Traiter vos commandes

Maintenant que vous savez accepter des paiements, découvrez comment traiter les commandes.

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.

PayID	Description

`{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`.