Zahlungsmethoden zum Dashboard migrieren

Bei bestehenden Integrationen von Stripe Checkout, bei denen payment_method_types angegeben ist, müssen Sie diesen Parameter entfernen, um die Einstellungen für die Zahlungsmethoden auf das Dashboard zu übertragen. Nachdem Sie den Parameter aus Ihrer Integration entfernt haben, werden einige Zahlungsmethoden automatisch aktiviert, wie z. B. Karten und Wallets. Der Parameter currency schränkt die Zahlungsmethoden ein, die die Kundin/der Kunde in der Checkout-Sitzung sieht.

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',
})

Zeigen Sie Ihre Einstellungen für Zahlungsmethoden an, um die Zahlungsmethoden einzusehen, die Sie zurzeit akzeptieren. Diese Liste enthält die standardmäßig aktivierten Zahlungsmethoden wie Karten. Diese Zahlungsmethoden kosten gleich viel oder weniger als Karten und werden sofort abgewickelt.

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.

Auf der Dashboard-Seite für die Einstellungen der Zahlungsmethoden können Sie die verfügbaren Zahlungsmethoden anzeigen und neue Zahlungsmethoden für Ihre Integration aktivieren.

Sie können einige Zahlungsmethoden aktivieren, indem Sie einfach Aktivieren auswählen. Zur Aktivierung einiger Zahlungsmethoden sind jedoch zusätzliche Schritte erforderlich. In diesen Fällen wird eine Schaltfläche mit der Bezeichnung Einrichten oder Überprüfen Sie Ihre Konditionen angezeigt.

Im Leitfaden zu Zahlungsmethoden finden Sie Informationen darüber, welche Zahlungsmethode sich für Ihre Zwecke am besten eignet.

Je nach Art der von Ihnen integrierten Zahlungsmethode kann sich die Zahlungsbestätigung um 2–14 Tage verzögern. Wenn Sie Webhooks zur automatischen Ausführung von Bestellungen mit Ihrer Checkout-Integration eingerichtet haben, müssen Sie möglicherweise Ihren Code aktualisieren, wenn Sie Ihre ersten Zahlungsmethoden mit verzögerter Benachrichtigung hinzufügen.

Wenn Sie Zahlungen mit einer Zahlungsmethode mit verzögerter Benachrichtigung erhalten, sind Gelder nicht sofort verfügbar. Die Verarbeitung der Gelder kann mehrere Tage dauern. Sie sollten daher die Auftragsabwicklung verschieben, bis die Gelder auf Ihrem Konto verfügbar sind. Nach erfolgreicher Zahlung ändert sich der zugrunde liegende PaymentIntent-Status von processing in succeeded.

Sie müssen folgende Checkout-Ereignisse verarbeiten:

Diese Ereignisse beinhalten alle das Checkout Session-Objekt.

Aktualisieren Sie Ihren Ereignis-Handler, um die Bestellung abzuwickeln:

# 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

Testen

Stellen Sie sicher, dass stripe listen weiterhin ausgeführt wird. Durchlaufen Sie wie in den vorangegangenen Schritten den Bezahlvorgang als Testnutzer. Ihr Ereignis-Handler sollte das Ereignis checkout.session.completed empfangen und Sie sollten es erfolgreich abgeschlossen haben.

Nachdem Sie diese Schritte ausgeführt haben, können Sie mit der Produktion beginnen, wann immer Sie bereit sind.

Hier finden Sie weitere Informationen zum Testen Ihrer Integration.