Vipps / MobilePay

Vipps (Norja) ja MobilePay (Tanska/Suomi) ovat suosittuja pohjoismaisia mobiilimaksutapoja, jotka on nyt yhdistetty yhdeksi integraatioksi.

Asetukset

Asetus	Arvo
`payment_method`	`"vipps-mobilepay"`

Tilauksen luominen

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

Sisällytä phone_numbers customer-objektiin esitäyttääksesi asiakkaan puhelinnumeron Vipps/MobilePay-sovelluksessa, mikä vähentää kitkaa.

Valtuutus ja veloitus

Vipps/MobilePay tukee manuaalista valtuutusta erillisellä veloituksella:

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

Veloitusvaihtoehdot

Valtuutuksen jälkeen veloita käyttäen mitä tahansa näistä menetelmistä:

Päätepiste	Kuvaus
`POST /v1/orders/\{id\}/captures/`	Täysi veloitus
`POST /v1/orders/\{id\}/captures/amount/`	Veloita tietty summa
`POST /v1/orders/\{id\}/captures/orderlines/`	Veloita tilausrivin mukaan

Palautukset

Palauta Vipps/MobilePay-maksu:

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

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

Testaus

Vipps/MobilePay-testaus tehdään Vippsin testiympäristössä. Ota yhteyttä tukeen testitunnusten ja ympäristön käyttöönottoa varten.

Lisätietoja veloitus- ja mitätöintioperaatioista löydät Valtuutus / Veloitus / Mitätöinti -oppaasta. Palautusten käsittelystä katso Palautukset.