Vipps / MobilePay

Vipps (Norsko) a MobilePay (Dánsko/Finsko) jsou populární severské mobilní platební metody, nyní sjednocené v jedné integraci.

Konfigurace

Nastavení	Hodnota
`payment_method`	`"vipps-mobilepay"`

Vytvoření objednávky

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

Zahrňte phone_numbers v objektu customer pro předvyplnění telefonního čísla zákazníka v aplikaci Vipps/MobilePay, čímž snížíte tření.

Autorizace a zachycení

Vipps/MobilePay podporuje manuální autorizaci se samostatným zachycením:

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

Možnosti zachycení

Po autorizaci zachyťte prostředky jednou z těchto metod:

Endpoint	Popis
`POST /v1/orders/\{id\}/captures/`	Úplné zachycení
`POST /v1/orders/\{id\}/captures/amount/`	Zachycení konkrétní částky
`POST /v1/orders/\{id\}/captures/orderlines/`	Zachycení podle řádku objednávky

Refundace

Refundace platby Vipps/MobilePay:

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

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

Testování

Testování Vipps/MobilePay probíhá prostřednictvím testovacího prostředí Vipps. Pro testovací přihlašovací údaje a nastavení prostředí kontaktujte podporu.

Další informace o operacích zachycení a zrušení najdete v průvodci Autorizace / Zachycení / Zrušení. Pro detaily zpracování refundací viz Vrácení plateb.