Vipps-ZahlungenPrivate Vorschau

Nutzen Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe API über Ihre Anwendung:

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Ein PaymentIntent ist ein Objekt, das Ihre Absicht, Zahlungen von Kundinnen und Kunden einzuziehen, darstellt und den gesamten Zahlungsvorgang dokumentiert. Erstellen Sie zunächst einen PaymentIntent auf Ihrem Server und geben Sie den einzuziehenden Betrag und die nok-Währung an, da Vipps nur nok unterstützt. Falls Sie bereits über eine Integration verfügen, die die Payment Intents API verwendet, fügen Sie der Liste der Zahlungsmethoden für Ihren PaymentIntent die Zahlungsmethode vipps hinzu.

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=1099 \
  -d "currency"="nok" \
  -d "payment_method_types[]"="vipps" \
  -d "payment_method_data[type]"="vipps" \
  -d "payment_method_options[vipps][reference]"="ORDER_123"

Antwort

{
  "id": "pi_12345",
  "amount": 1099,
  "currency": "nok",
  "payment_method": "pm_12345",
  "payment_method_types": [
     "vipps"
  ],
  "payment_method_options": {
    "vipps": {
      "reference": "ORDER_123",
    },
  },
  "status": "requires_confirmation"
}

Verwenden Sie die ID des PaymentIntent aus Schritt 2, um den PaymentIntent zu bestätigen. Dadurch wird erklärt, dass die Kundin/der Kunde beabsichtigt, mit der angegebenen PaymentMethod zu bezahlen. Nachdem der PaymentIntent bestätigt wurde, wird die Zahlung eingeleitet. Die return_url gibt an, wohin Stripe Nutzer/innen nach dem Zahlungsabschluss weiterleitet.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/confirm \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "return_url"="https://example.com/checkout/complete"

Antwort

{
  "id": "pi_12345",
  "amount": 1099,
  "currency": "nok",
  "payment_method": "pm_12345",
  "next_action": {
    "redirect_to_url": {
      "return_url": "https://example.com/checkout/complete",
      "url": "https://pm-redirects.stripe.com/authorize/acct_123/pa_nonce_abc"
    },
    "type": "redirect_to_url"
  },
  "payment_method_types": [
     "vipps"
  ],
  "payment_method_options": {
    "vipps": {
      "reference": "ORDER_123",
    },
  },
  "status": "requires_action"
}

Um die Zahlung zu autorisieren, leiten Sie Ihre Kundinnen/Kunden an die URL im Feld next_action[redirect_to_url][url] weiter.

• Auf einem Desktop öffnet die URL eine Vipps-Zielseite, auf der Kund/innen ihre Telefonnummer eingeben können, mit der ihr Vipps-Konto identifiziert wird. Sie können dann die Vipps-Smartphone-App verwenden, um mit der Zahlungsautorisierung fortzufahren.

• Auf Mobilgeräten öffnet die URL direkt die Vipps-Anwendung (falls vorhanden) oder die Zielseite von Vipps, ähnlich wie auf einem Desktop.

Verwenden Sie eine Methode wie Webhooks, um die Ausführung von Bestellungen abzuwickeln. Wenn eine Kundin/ein Kunde eine Zahlung abschließt, wechselt der Status des PaymentIntent zu succeeded und das Webhook-Ereignis payment_intent.succeeded wird gesendet. Wenn kundenseitig keine Zahlung erfolgt, sendet der PaymentIntent das Webhook-Ereignis payment_intent.payment_failed und wechselt wieder in den Status requires_payment_method.