Vipps / MobilePay

Vipps (Norvegia) e MobilePay (Danimarca/Finlandia) sono popolari metodi di pagamento mobile nordici, ora unificati in un'unica integrazione.

Configurazione

Impostazione	Valore
`payment_method`	`"vipps-mobilepay"`

Creare un Ordine

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

Includi phone_numbers nell'oggetto customer per precompilare il numero di telefono del cliente nell'app Vipps/MobilePay, riducendo l'attrito.

Autorizzazione e Cattura

Vipps/MobilePay supporta l'autorizzazione manuale con cattura separata:

POST /v1/orders/ (con autorizzazione)

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

Opzioni di Cattura

Dopo l'autorizzazione, cattura utilizzando uno di questi metodi:

Endpoint	Descrizione
`POST /v1/orders/\{id\}/captures/`	Cattura totale
`POST /v1/orders/\{id\}/captures/amount/`	Cattura di un importo specifico
`POST /v1/orders/\{id\}/captures/orderlines/`	Cattura per riga dell'ordine

Rimborsi

Rimborsa un pagamento Vipps/MobilePay:

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

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

Test

Il test di Vipps/MobilePay viene effettuato tramite l'ambiente di test Vipps. Contatta il supporto per le credenziali di test e la configurazione dell'ambiente.

Per maggiori dettagli sulle operazioni di cattura e annullamento, consulta la guida Autorizzazione / Cattura / Annullamento. Per i dettagli sull'elaborazione dei rimborsi, consulta Rimborsi.