Zahlungsmethoden zum Dashboard migrieren

Bei bestehenden Integrationen von Stripe Checkout müssen Sie den Parameter payment_method_types entfernen, um die Einstellungen für die Zahlungsmethoden zum Dashboard zu migrieren. 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 Ihren Kund/innen in der Checkout-Sitzung angezeigt werden.

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

Sie können Ihre derzeit akzeptierten Zahlungsmethoden in den Einstellungen der Zahlungsmethoden im Dashboard einsehen. Die Liste enthält Zahlungsmethoden, die Stripe standardmäßig aktiviert, z. B. Karten.

Sie können auch einzelne Zahlungsmethoden wie Apple Pay oder Google Pay aktivieren oder deaktivieren. Mit der Checkout Sessions API wertet Stripe die Währungen und etwaige Einschränkungen aus und zeigt den Kund/innen dann dynamisch die unterstützten Zahlungsmethoden an.

Beispielsweise ist Apple Pay standardmäßig aktiviert, Google Pay dagegen standardmäßig deaktiviert. In einigen Fällen zeigt Stripe diese Zahlungsmethoden möglicherweise nicht an, auch wenn Sie sie aktiviert haben. Stripe zeigt Google Pay nicht an, wenn Sie automatische Steuerberechnung aktivieren, ohne eine Versandadresse zu erfassen.

Geben Sie eine Transaktions-ID ein oder legen Sie einen Bestellbetrag und eine Währung im Dashboard fest, um zu sehen, wie Stripe Ihre Zahlungsmethoden den Kund/innen anzeigt.

Aktivieren Sie Zahlungsmethoden für Ihre Integration in den Einstellungen der Zahlungsmethoden im Dashboard. Sie können Aktivieren auswählen, um einige Zahlungsmethoden zu aktivieren. Wählen Sie für Zahlungsmethoden, die zusätzliche Schritte erfordern, Einrichten oder Konditionen prüfen aus.

In unserem Leitfaden zu Zahlungsmethoden erfahren Sie, welche Zahlungsmethoden für Ihr Unternehmen geeignet sind.

Die von Ihnen integrierte Zahlungsmethode weist möglicherweise eine verzögerte Zahlungsbestätigung auf. Wenn Sie Webhooks zur automatischen Ausführung von Bestellungen einrichten, müssen Sie möglicherweise Ihre Checkout-Integration aktualisieren, wenn Sie Ihre erste Zahlungsmethode mit verzögerten Benachrichtigungen 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 Bestellabwicklung verschieben, bis die Gelder auf Ihrem Konto verfügbar sind. Nach erfolgreicher Zahlung ändert sich der Status des zugrunde liegenden PaymentIntent 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_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

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.