Vipps / MobilePay

Vipps (Noorwegen) en MobilePay (Denemarken/Finland) zijn populaire Scandinavische mobiele betaalmethoden, nu samengevoegd in een enkele integratie.

Configuratie

Instelling	Waarde
`payment_method`	`"vipps-mobilepay"`

Een bestelling aanmaken

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"]
  }
}

Neem phone_numbers op in het customer-object om het telefoonnummer van de klant vooraf in te vullen in de Vipps/MobilePay-app, wat de drempel verlaagt.

Autorisatie & Capture

Vipps/MobilePay ondersteunt handmatige autorisatie met afzonderlijke capture:

POST /v1/orders/ (met autorisatie)

{
  "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"
    }
  ]
}

Capture-opties

Na autorisatie kunt u capturen met een van deze methoden:

Eindpunt	Beschrijving
`POST /v1/orders/\{id\}/captures/`	Volledige capture
`POST /v1/orders/\{id\}/captures/amount/`	Specifiek bedrag capturen
`POST /v1/orders/\{id\}/captures/orderlines/`	Capturen per orderregel

Terugbetalingen

Een Vipps/MobilePay-betaling terugbetalen:

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

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

Testen

Het testen van Vipps/MobilePay gebeurt via de Vipps-testomgeving. Neem contact op met support voor testgegevens en omgevingsconfiguratie.

Voor meer details over capture- en void-operaties, zie de handleiding Autorisatie / Capture / Void. Voor details over terugbetalingsverwerking, zie Terugbetalingen.