Vipps / MobilePay

Vipps (Norvège) et MobilePay (Danemark/Finlande) sont des méthodes de paiement mobile nordiques populaires, désormais unifiées sous une seule intégration.

Configuration

Paramètre	Valeur
`payment_method`	`"vipps-mobilepay"`

Créer une commande

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

Incluez phone_numbers dans l'objet customer pour préremplir le numéro de téléphone du client dans l'application Vipps/MobilePay, réduisant ainsi les frictions.

Autorisation et capture

Vipps/MobilePay prend en charge l'autorisation manuelle avec capture séparée :

POST /v1/orders/ (avec autorisation)

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

Options de capture

Après l'autorisation, capturez en utilisant l'une de ces méthodes :

Point d'accès	Description
`POST /v1/orders/\{id\}/captures/`	Capture totale
`POST /v1/orders/\{id\}/captures/amount/`	Capture d'un montant spécifique
`POST /v1/orders/\{id\}/captures/orderlines/`	Capture par ligne de commande

Remboursements

Rembourser un paiement Vipps/MobilePay :

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

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

Tests

Les tests Vipps/MobilePay sont effectués via l'environnement de test Vipps. Contactez le support pour les identifiants de test et la configuration de l'environnement.

Pour plus de détails sur les opérations de capture et d'annulation, consultez le guide Autorisation / Capture / Annulation. Pour les détails sur le traitement des remboursements, consultez Remboursements.