Vipps / MobilePay

Vipps (Norwegen) und MobilePay (Dänemark/Finnland) sind beliebte nordische mobile Zahlungsmethoden, die nun unter einer Integration vereint sind.

Konfiguration

Einstellung	Wert
`payment_method`	`"vipps-mobilepay"`

Bestellung erstellen

POST /v1/orders/

{
  "merchant_order_id": "order-456",
  "currency": "NOK",
  "amount": 29900,
  "return_url": "https://www.example.com",
  "webhook_url": "https://www.example.com/webhook",
  "transactions": [
    {
      "payment_method": "vipps-mobilepay"
    }
  ],
  "customer": {
    "phone_numbers": ["+4712345678"]
  }
}

Fügen Sie phone_numbers im customer-Objekt hinzu, um die Telefonnummer des Kunden in der Vipps/MobilePay-App vorzubefüllen und so die Reibung zu reduzieren.

Autorisierung & Erfassung

Vipps/MobilePay unterstützt manuelle Autorisierung mit separater Erfassung:

POST /v1/orders/ (with authorization)

{
  "currency": "NOK",
  "amount": 29900,
  "capture_mode": "manual",
  "return_url": "https://www.example.com",
  "webhook_url": "https://www.example.com/webhook",
  "transactions": [
    {
      "payment_method": "vipps-mobilepay"
    }
  ]
}

Erfassungsoptionen

Nach der Autorisierung erfassen Sie mit einer dieser Methoden:

Endpunkt	Beschreibung
`POST /v1/orders/\{id\}/captures/`	Vollständige Erfassung
`POST /v1/orders/\{id\}/captures/amount/`	Bestimmten Betrag erfassen
`POST /v1/orders/\{id\}/captures/orderlines/`	Nach Bestellposition erfassen

Erstattungen

Eine Vipps/MobilePay-Zahlung erstatten:

POST /v1/orders/{id}/refunds/

{
  "amount": 10000,
  "description": "Partial refund"
}

Testen

Das Testen von Vipps/MobilePay erfolgt über die Vipps-Testumgebung. Kontaktieren Sie den Support für Testzugangsdaten und Umgebungseinrichtung.

Weitere Details zu Erfassungs- und Stornierungsoperationen finden Sie in der Anleitung Autorisierung / Erfassung / Stornierung. Für Details zur Erstattungsverarbeitung siehe Erstattungen.