Vipps / MobilePay

Vipps (Norra) ja MobilePay (Taani/Soome) on populaarsed Põhjamaade mobiilimakseviisid, mis on nüüd ühendatud ühe integratsiooni alla.

Seadistamine

Seadistus	Väärtus
`payment_method`	`"vipps-mobilepay"`

Tellimuse loomine

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

Lisage customer objekti phone_numbers, et eeltäita kliendi telefoninumber Vipps/MobilePay rakenduses, vähendades hõõrdumist.

Autoriseerimine ja hõivamine

Vipps/MobilePay toetab käsitsi autoriseerimist eraldi hõivamisega:

POST /v1/orders/ (autoriseerimisega)

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

Hõivamise valikud

Pärast autoriseerimist hõivake, kasutades ühte järgmistest meetoditest:

Lõpp-punkt	Kirjeldus
`POST /v1/orders/\{id\}/captures/`	Täielik hõivamine
`POST /v1/orders/\{id\}/captures/amount/`	Konkreetse summa hõivamine
`POST /v1/orders/\{id\}/captures/orderlines/`	Hõivamine tellimuse rea kaupa

Tagasimaksed

Vipps/MobilePay makse tagasimaksmine:

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

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

Testimine

Vipps/MobilePay testimine toimub Vipps testkeskkonna kaudu. Testmandaatide ja keskkonna seadistamise kohta võtke ühendust toega.

Lisateavet hõivamise ja tühistamise toimingute kohta leiate juhendist Autoriseerimine / hõivamine / tühistamine. Tagasimaksete töötlemise kohta vaadake Tagasimaksed.