Migrer des moyens de paiement vers le Dashboard

Pour les intégrations Stripe Checkout existantes qui spécifient payment_method_types, vous devez supprimer ce paramètre pour migrer les préférences des moyens de paiement vers le Dashboard. Après avoir supprimé le paramètre de votre intégration, certains moyens de paiement sont activés automatiquement, notamment les cartes et les portefeuilles. 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. La liste inclut les moyens de paiement activés par défaut, tels que les paiements par carte bancaire. Leur coût est égal ou inférieur à celui des paiements par carte et sont réglés immédiatement.

Payment methods

By default, Stripe enables cards and other common payment methods. You can turn individual payment methods on or off in the Stripe Dashboard. In Checkout, Stripe evaluates the currency and any restrictions, then dynamically presents the supported payment methods to the customer.

To see how your payment methods appear to customers, enter a transaction ID or set an order amount and currency in the Dashboard.

You can enable Apple Pay and Google Pay in your payment methods settings. By default, Apple Pay is enabled and Google Pay is disabled. However, in some cases Stripe filters them out even when they’re enabled. We filter ApplePay if you set setup_future_usage (either top-level or in payment_method_options for card), and we filter Google Pay if you enable automatic tax without collecting a shipping address.

Checkout’s Stripe-hosted pages don’t need integration changes to enable Apple Pay or Google Pay. Stripe handles these payments the same way as other card payments.

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 en savoir plus sur les moyens de paiement adaptés à 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 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_4eC39HqLyjWDarjtT1zdp7dc'

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