Accepter un virement bancaire

Une session Checkout doit remplir toutes les conditions suivantes pour prendre en charge les paiements Bank Transfer :

• Les tarifs de tous les postes de facture doivent être exprimés dans la même devise. Pour définir des postes dans différentes devises, créez des sessions Checkout distinctes pour chacune d’entre elles.

• Vous ne pouvez utiliser que les postes ponctuels (les sessions Checkout avec virement bancaire ne prennent pas en charge les plans d’abonnement récurrents).

Utilisez ce guide pour activer Bank Transfer.

Créer ou récupérer un Customer

Vous devez associer un objet Customer à chaque paiement par virement bancaire à des fins de rapprochement. Si vous possédez déjà un objet Customer, vous pouvez ignorer cette étape. Sinon, créez un nouvel objet Customer.

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

Activer le moyen de paiement Bank Transfer

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

1. Définir customer
2. Ajouter customer_balance à la liste des payment_method_types
3. Veiller à ce que tous vos line_items utilisent la même devise

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=customer_balance \
  -d "payment_method_options[customer_balance][funding_type]"=bank_transfer \
  -d "payment_method_options[customer_balance][bank_transfer][type]"=us_bank_transfer \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/failure"

Rediriger vers la page d’instruction concernant les virements bancaires hébergée par Stripe

Une fois le formulaire Checkout envoyé,

• Si le solde du client permet de payer le montant requis, le paiement est effectué immédiatement et le client est redirigé vers le lien success_url.
• Si le solde du client n’est pas suffisant pour payer le montant requis, il est redirigé vers la hosted_instructions_url. Cette page contient des instructions pour aider votre client à effectuer le virement.

Stripe vous permet de personnaliser les interfaces utilisateur sur la page Adaptation à votre marque. Vous pouvez appliquer les paramètres de marque suivants à la page d’instructions hébergée :

• Icône : image représentant votre marque et votre dénomination sociale publique
• Couleur de marque : utilisée comme couleur d’arrière-plan

Traiter vos commandes

Because bank transfer is a delayed notification payment method, you need to use a method such as webhooks to monitor the payment status and handle order fulfillment. Learn more about setting up webhooks and fulfilling orders.

Les événements suivants sont envoyés lorsque l’état du paiement change :

Vous pouvez tester votre intégration en simulant un virement bancaire entrant à l’aide de l’API, du Dashboard ou d’une version bêta de l’interface de ligne de commande Stripe.