Accepter un virement bancaire

Pour commencer, il vous faut un compte Stripe. Inscrivez-vous.

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'

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_BQokikJOvBiI2HlWgH4olfQ2
:"

Un PaymentIntent est un objet qui représente votre intention d’encaisser un paiement client et qui suit le cycle de vie du processus de paiement étape par étape. Créez et confirmez un PaymentIntent sur le serveur et précisez le montant à encaisser ainsi que la devise. Vous devez également remplir les paramètres client de la demande de création du Paymentintent. Les virements bancaires ne sont pas disponibles sur les PayentIntents sans client.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d customer=
{{CUSTOMER_ID}} \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true \
  --data-urlencode return_url="https://example.com/return_url" \
  -d "payment_method_data[type]"=customer_balance \
  -d confirm=true

Si le solde du client n’est pas suffisant pour payer le montant requis, le PaymentIntent affiche l’état requires_action. La réponse comporte un champ next_action dont la valeur type est définie sur display_bank_transfer_instructions. Le hachage next_action[display_bank_transfer_instructions] contient les informations que vous devez montrer à votre client pour qu’il effectue le virement bancaire. Pour garantir le règlement des fonds, demandez à vos clients d’utiliser les informations exactes fournies, en particulier le nom et le numéro de compte, le cas échéant.

{
  "aba": {
    "account_number": "111222333444",
    "bank_name": "Wells Fargo Bank, NA",
    "routing_number": "444555666"
  },
  "supported_networks": [
    "ach",
    "domestic_wire_us"
  ],
  "type": "aba"
}

{
  "swift": {
    "account_number": "111222333444",
    "bank_name": "Wells Fargo Bank, NA",
    "swift_code": "AAAA-BB-CC-123"
  },
  "supported_networks": [
    "swift"
  ],
  "type": "swift"
}

Le PaymentIntent reste à l’état requires_action jusqu’à ce que les fonds arrivent sur le compte bancaire. Dès réception du paiement, l’état du PaymentIntent associé passe de l’état requires_action à succeeded.

Vous devez configurer votre endpoint de webhook pour commencer à recevoir l’événement `payment_intent.partially_funded``.

Vous pouvez ajouter un webhook depuis le Dashboard.

Vous pouvez aussi utiliser l’API Webhook Endpoints pour recevoir l’événement payment_intent.partially_funded.

Au cours du flux de financement du paiement, Stripe envoie les événements suivants lorsque le PaymentIntent est mis à jour.

Nous vous recommandons d’utiliser des webhooks afin de confirmer que le paiement a abouti et pour signaler au client que le paiement a été effectué.

Exemple de code

require 'json'

# Using Sinatra
post '/webhook' do
  payload = request.body.read
  event = nil

  begin
    event = Stripe::Event.construct_from(
      JSON.parse(payload, symbolize_names: true)

Consulter les paiements en attente sur le Dashboard

Vous pouvez consulter les PaymentIntents associés à des virements bancaires en attente dans le Dashboard en appliquant le filtre En attente de financement au champ État.

Vous pouvez tester votre intégration en simulant un virement bancaire entrant soit à l’aide du Dashboard, soit à l’aide d’une requête HTTP.

curl https://api.stripe.com/v1/test_helpers/customers/ic_xxxxxxxxx/fund_cash_balance \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d reference=REF-4242

Les codes d’erreur suivants indiquent que des problèmes temporaires affectent la disponibilité du moyen de paiement :