Vipps / MobilePay

Vipps (Noruega) e MobilePay (Dinamarca/Finlândia) são métodos de pagamento móvel populares nos países nórdicos, agora unificados numa única integração.

Configuração

Definição	Valor
`payment_method`	`"vipps-mobilepay"`

Criar uma Encomenda

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

Inclua phone_numbers no objeto customer para pré-preencher o número de telefone do cliente na aplicação Vipps/MobilePay, reduzindo a fricção.

Autorização e Captura

Vipps/MobilePay suporta autorização manual com captura separada:

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

Opções de Captura

Após a autorização, capture utilizando qualquer um destes métodos:

Endpoint	Descrição
`POST /v1/orders/\{id\}/captures/`	Captura total
`POST /v1/orders/\{id\}/captures/amount/`	Capturar montante específico
`POST /v1/orders/\{id\}/captures/orderlines/`	Capturar por linha de encomenda

Reembolsos

Reembolsar um pagamento Vipps/MobilePay:

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

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

Testes

Os testes de Vipps/MobilePay são feitos através do ambiente de teste do Vipps. Contacte o suporte para credenciais de teste e configuração do ambiente.

Para mais detalhes sobre operações de captura e anulação, consulte o guia de Autorização / Captura / Anulação. Para detalhes sobre processamento de reembolsos, consulte Reembolsos.