Skip to main content

Freestanding cards

View as Markdown (opens in a new tab)
Install AI tools

Our plugin gives your assistant up-to-date guidance for payments and login. Full instructions

Run both commands, in order.

claude plugin marketplace add vippsas/agent-toolkit
claude plugin install vipps@agent-toolkit

The ePayment API supports freestanding card payments, where any user can pay with a card without using the app. This lets merchants accept payments from customers in countries where the Vipps or MobilePay app is not yet available.

Tip

For a visual walkthrough of the customer's experience with freestanding cards, see How it works with freestanding cards.

Screenshot: Mobile checkout payment method selection showing the app brand (Vipps or MobilePay) with Card as an alternative option.

Authorization​

All ePayment API requests must include a valid Bearer token in the Authorization header. See Authorization for how to obtain one.

Request​

To initiate a freestanding card payment, call the create payment endpoint, POST:/epayment/v1/payments. Specify paymentMethod.type = "CARD".

For example:

curl -X POST https://apitest.vipps.no/epayment/v1/payments \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR-ACCESS-TOKEN" \
-H "Ocp-Apim-Subscription-Key: YOUR-SUBSCRIPTION-KEY" \
-H "Merchant-Serial-Number: YOUR-MSN" \
-H 'Idempotency-Key: YOUR-IDEMPOTENCY-KEY' \
-H "Vipps-System-Name: acme" \
-H "Vipps-System-Version: 3.1.2" \
-H "Vipps-System-Plugin-Name: acme-webshop" \
-H "Vipps-System-Plugin-Version: 4.5.6" \
-d '{
  "paymentMethod": {
    "type": "CARD"
  },
  "amount": {
    "currency": "NOK",
    "value": 49900
  },
  "reference": "acme-shop-123-order123abc",
  "returnUrl": "https://example.com/redirect?reference=acme-shop-123-order123abc",
  "userFlow": "WEB_REDIRECT",
  "paymentDescription": "Online purchase of sportswear",
  "receiptUrl":"https://example.com/link/to/my.pdf"

The response for the request above will contain a redirectUrl pointing to the web page with a form where the user enters the payment card details. The card entry page opens, where they enter their card details.

Enter card details

Screenshot: Card payment entry form with fields for card number, expiry date, and CVC, with a Pay button.

After submitting the card details, the user is redirected back to the merchant's store, where the order confirmation is shown.

Note

The card entry page is not currently available in the test environment.

Last updated on