Migrer les moyens de paiement vers le Dashboard

Pour les intégrations Stripe Checkout existantes, vous devez supprimer le paramètre payment_method_types pour migrer les préférences des moyens de paiement vers le Dashboard. Ce faisant, certains moyens de paiement s’activent automatiquement, notamment les cartes et les wallets. Le paramètre currency limite les moyens de paiement que vos clients voient dans la session Checkout.

Stripe::Checkout::Session.create({
  line_items: [
    {
      price_data: {
        currency: 'eur',
        product_data: {name: 'T-shirt'},
        unit_amount: 2000,
      },
      quantity: 1,
    },
  ],
  mode: 'payment',
  # Remove the payment_method_types parameter to manage payment methods in the Dashboard
  payment_method_types: ['card'],
  return_url: 'https://example.com/return',
  ui_mode: 'custom',
})

Vous pouvez voir les moyens de paiement que vous acceptez actuellement à partir des paramètres des moyens de paiement dans le Dashboard. La liste comprend les moyens de paiement que Stripe active par défaut, comme les cartes bancaires.

Vous pouvez également activer ou désactiver des moyens de paiement individuels, tels qu’Apple Pay ou Google Pay. Avec l’API Checkout Sessions, Stripe évalue la devise et les éventuelles restrictions, puis présente dynamiquement au client les moyens de paiement pris en charge.

Par exemple, Apple Pay est activé et Google Pay est désactivé par défaut. Dans certains cas, Stripe peut ne pas afficher ces moyens de paiement, même si vous les avez activés. Stripe n’affiche pas Google Pay si vous activez la taxe automatique sans collecter d’adresse de livraison.

Pour voir comment Stripe affiche vos moyens de paiement aux clients, saisissez un identifiant de transaction ou définissez un montant de commande et une devise dans le Dashboard.

Activez les moyens de paiement pour votre intégration à partir des paramètres des moyens de paiement dans le Dashboard. Vous pouvez sélectionner Activer pour certains moyens de paiement. Pour les moyens de paiement nécessitant des étapes supplémentaires, sélectionnez Configurer ou Vérifier les conditions.

Découvrez quels sont les moyens de paiement adaptés à votre entreprise en consultant notre guide des moyens de paiement.

Le moyen de paiement que vous intégrez peut avoir une confirmation de paiement retardée. Si vous avez configuré des webhooks pour exécuter automatiquement les commandes, vous devrez peut-être mettre à jour votre intégration Checkout lorsque vous ajouterez votre premier moyen de paiement avec notifications différées.

Lorsque vous recevez des paiements avec un moyen de paiement à notification différée, les fonds ne sont pas immédiatement disponibles. Le traitement des fonds peut prendre plusieurs jours. Vous devez donc retarder le traitement de la commande jusqu’à ce que les fonds soient disponibles sur votre compte. Une fois le paiement effectué, l’état du PaymentIntent sous-jacent passe de processing à succeeded.

Vous devrez gérer les événements Checkout suivants :

Ces événements contiennent tous l’objet Checkout Session.

Actualisez votre gestionnaire d’événements pour traiter la commande :

# 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'

# You can find your endpoint's secret in the output of the `stripe listen`
# command you ran earlier
endpoint_secret = 'whsec_...'

post '/webhook' do
  event = nil

  # Verify webhook signature and extract the event
  # See https://stripe.com/docs/webhooks#verify-events for more information.
  begin
    sig_header = request.env['HTTP_STRIPE_SIGNATURE']
    payload = request.body.read
    event = Stripe::Webhook.construct_event(payload, sig_header, endpoint_secret)
  rescue JSON::ParserError => e
    # Invalid payload
    return status 400
  rescue Stripe::SignatureVerificationError => e
    # Invalid signature
    return status 400
  end

  case event['type']
  if event['type'] == 'checkout.session.completed'
    checkout_session = event['data']['object']

    fulfill_order(checkout_session)
  end
  when 'checkout.session.completed'
    checkout_session = event['data']['object']

    # Save an order in your database, marked as 'awaiting payment'
    create_order(checkout_session)

    # Check if the order is already paid (for example, from a card payment)
    #
    # A delayed notification payment will have an `unpaid` status, as
    # you're still waiting for funds to be transferred from the customer's
    # account.
    if checkout_session.payment_status == 'paid'
      fulfill_order(checkout_session)
    end
  when 'checkout.session.async_payment_succeeded'
    checkout_session = event['data']['object']

    # Fulfill the purchase...
    fulfill_order(checkout_session)
  when 'checkout.session.async_payment_failed'
    session = event['data']['object']

    # Send an email to the customer asking them to retry their order
    email_customer_about_failed_payment(checkout_session)
  end

  status 200
end

def fulfill_order(checkout_session)
  # TODO: fill in with your own logic
  puts "Fulfilling order for #{checkout_session.inspect}"
end

def create_order(checkout_session)
  # TODO: fill in with your own logic
  puts "Creating order for #{checkout_session.inspect}"
end

def email_customer_about_failed_payment(checkout_session)
  # TODO: fill in with your own logic
  puts "Emailing customer about payment failure for: #{checkout_session.inspect}"
end

Test

Vérifiez que stripe listen est toujours en cours d’exécution. Testez Checkout en tant qu’utilisateur, comme vous l’avez fait dans les étapes précédentes. Votre gestionnaire d’événements devrait recevoir un événement checkout.session.completed et vous devriez l’avoir géré avec succès.

Maintenant que vous avez suivi ces étapes, vous pouvez passer en mode production quand bon vous semble.

Consultez la section consacrée aux tests pour obtenir des informations supplémentaires sur la manière de tester votre intégration.