Vipps / MobilePay

Vipps (Norway) and MobilePay (Denmark/Finland) are popular Nordic mobile payment methods, now unified under one integration.

Configuration

Setting	Value
`payment_method`	`"vipps-mobilepay"`

Creating an Order

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

[!TIP] Include phone_numbers in the customer object to pre-fill the customer's phone number in the Vipps/MobilePay app, reducing friction.

Authorization & Capture

Vipps/MobilePay supports manual authorization with separate capture:

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

Capture Options

After authorization, capture using any of these methods:

Endpoint	Description
`POST /v1/orders/\{id\}/captures/`	Full capture
`POST /v1/orders/\{id\}/captures/amount/`	Capture specific amount
`POST /v1/orders/\{id\}/captures/orderlines/`	Capture by order line

Refunds

Refund a Vipps/MobilePay payment:

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

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

Testing

Vipps/MobilePay testing is done via the Vipps test environment. Contact support for test credentials and environment setup.