Enregistrez vos informations pour vos futurs paiements par prélèvement automatique canadien

Pour commencer, il vous faut un compte Stripe. S’inscrire.

Utilisez nos bibliothèques officielles pour accéder à l’API Stripe depuis votre application :

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Pour réutiliser un compte bancaire pour des paiements futurs, le compte en question doit être associé à un objet Customer.

Créez un objet Customer lorsque votre client crée un compte auprès de votre entreprise. En associant l’ID de l’objet Customer à votre propre représentation interne de ce client, vous pourrez par la suite récupérer et utiliser les informations stockées concernant son moyen de paiement. Si votre client n’a pas créé de compte, il vous est toujours possible de lui créer un objet Customer sans attendre, que vous associerez ultérieurement à votre représentation interne de ce compte client.

Créez ou récupérez un objet Customer client afin de l’associer à ces informations de paiement. Ajoutez le code suivant à votre serveur pour créer un objet Customer.

curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Suivez ce guide pour savoir comment activer les prélèvements automatiques canadiens. Il vous présente les différences de configuration des paiements futurs, qu’ils soient effectués par carte ou via des prélèvements automatiques.

Activer les paiements par prélèvement automatique canadien comme moyen de paiement

Lors de la création d’une nouvelle session Checkout, vous devez :

Pre-authorized debit in Canada

1. Ajoutez acss_debit à la liste payment_method_types.
2. Définissez des paramètres payment_method_options supplémentaires pour décrire votre transaction. Découvrez plus d’informations à ce sujet ci-dessous.

La fréquence des paiements doit être définie, puis validée par les clients lors du paiement. Consultez la section Mandats de prélèvement automatique pour obtenir plus d’informations l’option de mandat qui convient de sélectionner pour votre entreprise :

Créer une session Checkout

Stripe::Checkout::Session.create({
  mode: 'setup',
  payment_method_types: ['card'],
  payment_method_types: ['acss_debit'],

  # or you can take multiple payment methods with
  # payment_method_types: ['card', 'acss_debit', ...]
  payment_method_options: {
    acss_debit: {
      currency: 'cad',
      mandate_options: {
        payment_schedule: 'interval',
        interval_description: 'First day of every month',
        transaction_type: 'personal',
      }
    }
  },
  customer: customer.id,
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Lors de la session Checkout, une fenêtre modale d’interface utilisateur s’affiche pour le client. Elle lui permet de gérer la collecte des informations du compte bancaire et la vérification instantanée, ainsi qu’une vérification supplémentaire facultative par microversements. Si le client opte pour cette vérification par microversements, Stripe envoie automatiquement deux versements d’un faible montant au compte bancaire indiqué. Ces versements apparaissent au bout d’un à deux jours ouvrables sur le relevé bancaire en ligne du client. Au moment de leur arrivée, le client reçoit un e-mail contenant un lien pour confirmer ces montants et vérifier le compte bancaire avec Stripe. Une fois cette vérification effectuée, le moyen de paiement est prêt à être utilisé pour les futurs paiements.

Recevoir un e-mail de vérification du micro-versement

Afin de recevoir l’e-mail de vérification du microversement dans un environnement de test une fois la collecte des informations du compte bancaire et l’acceptation d’un mandat effectuées, fournissez un e-mail dans le champ payment_method[billing_details][email] du formulaire de {any_prefix}+test_email@{any_domain} lors de la confirmation des informations du moyen de paiement.

Numéros de comptes de test

Stripe fournit plusieurs numéros de compte test que vous pouvez utiliser pour vous assurer que votre intégration pour les comptes bancaires saisis manuellement sont prêts pour le mode production. Tous les comptes test avec un paiement qui réussit ou échoue automatiquement doivent être vérifiés à l’aide des montants de microversement test ci-dessous avant de pouvoir être effectués.

Pour simuler les réussites ou les échecs de la vérification des comptes bancaires dans un environnement de test, utilisez ces montants représentatifs pour les microversements :

Une fois la session Checkout effectuée, vous pouvez collecter les ID des objets PaymentMethod et Mandate. Ils peuvent être utilisés pour initier des paiements futurs sans devoir demander les coordonnées bancaires du client une seconde fois.

Au moment de facturer votre client hors session, fournissez les ID des objets payment_method, customer et mandate lors de la création d’un PaymentIntent.