Migrer les comptes bancaires existants

Stripe supprimera bientôt le service de support pour ACH Direct Debit sur l’API Charges. Si vous créez des Payments ACH Direct Debit avec l’API Charges via l’API, Invoices ou Subscriptions, vous devez migrer vers l’API Payment Intents ou l’API Checkout Sessions. Avant de supprimer officiellement le service de support, nous vous enverrons plus de détails par e-mail.

Si vous avez précédemment collecté les informations de paiement de vos clients avec Stripe à l’aide de API Tokens, vous pouvez continuer à utiliser le BankAccount enregistré comme {% glossary term="payment-methods » %}PaymentMethod. Vous ne pouvez utiliser les comptes bancaires de vos clients avec l’API Payment Intents ou l’API Checkout Sessions qu’après avoir satisfait aux exigences suivantes :

• API Checkout Sessions : le compte bancaire du client a été vérifié.

• API Payment Intents : le compte bancaire du client a été vérifié et un mandat actif existe pour ce compte bancaire.

Vous n’avez pas besoin de revérifier les comptes bancaires qui sont déjà vérifiés pour les utiliser avec des Payment Intents ou des Checkout Sessions.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

session = Stripe::Checkout::Session.create({
  mode: 'payment',
  ui_mode: 'custom',
  customer: '{{CUSTOMER_ID}}',
  payment_method_types: ['us_bank_account'],
  line_items: [{
    price_data: {
      currency: 'usd',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 1099,
    },
    quantity: 1,
  }],
  saved_payment_method_options: {
    allow_redisplay_filters: ['unspecified', 'always'],
  },
  return_url: YOUR_DOMAIN + '/complete?session_id={CHECKOUT_SESSION_ID}',
})

const {checkout} = useCheckout();
const currentEmail = checkout.email;

if (currentEmail) {
  return <input value={currentEmail} readOnly />;
}

Récupérer un BankAccount en tant que PaymentMethod

Vous pouvez récupérer les BankAccounts enregistrés via l’API Payment Methods.

curl https://api.stripe.com/v1/payment_methods/ba_1IsleZ2eZvKYlo2CI3To1g72 \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Lorsqu’un BankAccount est utilisé comme PaymentMethod, aucun nouvel objet n’est créé. L’API Payment Methods propose simplement une vue différente du même objet sous-jacent.

{
  "id": "ba_1IsleZ2eZvKYlo2CI3To1g72",
  "object": "payment_method",
  "billing_details": {
    "address": {
      "city": null,
      "country": null,
      "line1": null,
      "line2": null,
      "postal_code": null,
      "state": null
    },
    "email": null,
    "name": "Jenny Rosen",
    "phone": null
  },
  "us_bank_account": {
    "last4": "6789",
    "routing_number": "110000000",
    "fingerprint": "1JWtPxqbdX5Gamtc",
    "account_holder_type": "individual",
    "bank_name": "STRIPE TEST BANK",
  },
  "created": 123456789,
  "customer": "cus_CY5bH92D99f4mn",
  "livemode": false,
  "metadata": {},
  "type": "us_bank_account"
}

Factures

Après avoir collecté l’acceptation du mandat, pour continuer à utiliser Invoicing, vous devez soit mettre à jour le moyen de paiement par défaut de votre client, soit définir le paramètre default_payment_method.

Pour mettre à jour le moyen de paiement par défaut d’un client :

curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[default_payment_method]"={{BANK_ACCOUNT_ID}}

Pour créer une facture avec un compte bancaire comme moyen de paiement :

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d default_payment_method={{BANK_ACCOUNT_ID}}

Abonnements

Après avoir collecté l’acceptation du mandat, pour continuer à utiliser Subscriptions, vous devez soit mettre à jour le moyen de paiement par défaut de votre client, soit définir le paramètre default_payment_method.

Pour mettre à jour le moyen de paiement par défaut d’un client :

curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[default_payment_method]"={{BANK_ACCOUNT_ID}}

Pour créer un abonnement avec un compte bancaire comme moyen de paiement :

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d default_payment_method={{BANK_ACCOUNT_ID}} \
  -d "items[0][price]"=price_1MowQULkdIwHu7ixraBm864M