Migrer des moyens de paiement vers le Dashboard

Pour les intégrations Stripe Checkout existantes qui précisent les types payment_method_types, vous devez supprimer ce paramètre pour pouvoir migrer les préférences des moyens de paiement vers le Dashboard. Une fois que vous avez retiré le paramètre de votre intégration, certains moyens de paiement sont activés automatiquement, notamment les cartes et les portefeuilles numériques. Le paramètre currency limite les moyens de paiement que le client voit 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'],
  success_url: 'https://example.com/success',
})

Accédez aux paramètres des moyens de paiement pour consulter les moyens de paiement que vous acceptez actuellement. Cette liste inclut les moyens de paiement activés par défaut, tels que les paiements par carte. Leur coût est égal ou inférieur à celui des paiements par carte et sont réglés immédiatement.

Modes de paiement

Par défaut, Stripe active les cartes et d’autres modes de paiement courants. Vous pouvez activer ou désactiver des moyens de paiement individuels dans le Dashboard Stripe. Dans Checkout, Stripe évalue la devise et les restrictions éventuelles, puis présente dynamiquement au client les modes de paiement pris en charge.

Pour voir comment vos moyens de paiement sont affichés pour les clients, saisissez un ID de transaction ou définissez un montant et une devise de commande dans le Dashboard.

Vous pouvez activer Apple Pay et Google Pay dans vos paramètres des moyens de paiement. Par défaut, Apple Pay est activé et Google Pay est désactivé. Cependant, dans certains cas, Stripe les filtre même lorsqu’ils sont activés. Nous filtrons Google Pay si vous activez les taxes automatiques sans collecter d’adresse de livraison.

Aucune modification de l’intégration n’est requise pour activer Apple Pay ou Google Pay dans les pages hébergées par Stripe de Checkout. Stripe gère ces paiements de la même manière que les autres paiements par carte.

Sur la page des paramètres des moyens de paiement du Dashboard, vous pouvez consulter les moyens de paiement disponibles et en activer de nouveaux pour votre intégration.

Vous pouvez activer certains moyens de paiement simplement en cliquant sur Activer. Cependant, vous devrez effectuer quelques étapes supplémentaires pour activer certains moyens de paiement. Dans ce cas, un bouton intitulé Configurer ou Consulter les conditions s’affiche.

Pour découvrir quels moyens de paiement peuvent convenir à votre entreprise, consultez notre Guide des moyens de paiement.

Selon le type de moyen de paiement que vous intégrez, la confirmation du paiement peut prendre entre 2 et 14 jours. Si vous configurez des webhooks pour traiter automatiquement les commandes avec votre intégration Checkout, il vous faudra peut-être mettre à jour votre code lorsque vous ajoutez vos premiers moyens de paiement à notification différée.

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 de la session Checkout.

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 Test pour obtenir des informations supplémentaires sur la manière de tester votre intégration.