How the ePayment PSP API works with online payments
Install AI tools
Our plugin gives your assistant up-to-date guidance for payments and login. Full instructions
- Claude Code
- Cursor
- Codex
- Any editor
Run both commands, in order.
claude plugin marketplace add vippsas/agent-toolkit
claude plugin install vipps@agent-toolkit
Open Settings, then Plugins.
Add vippsas/agent-toolkit as a plugin marketplace, then install the "vipps" plugin.
See the Codex plugin docs at developers.openai.com/codex.
Add vippsas/agent-toolkit as a plugin marketplace, then install the "vipps" plugin.
No plugin needed. Paste this into your assistant.
Read https://developer.vippsmobilepay.com/llms.txt for the Vipps MobilePay developer documentation.
A step-by-step walkthrough of an online payment using CARD_PASSTHROUGH, from the checkout page
to the final status update.
Details​
1. Customer selects their payment method​
On the checkout page, the customer chooses to pay with Vipps or MobilePay.
Screenshot: Mobile merchant cart page showing product details and a Pay with Vipps or Pay with MobilePay button.
2. The PSP creates a payment request​
When the customer selects to pay with Vipps or MobilePay, the PSP creates a payment request by sending
a POST:/epayment/v1/payments request with:
paymentMethod.typeset toCARD_PASSTHROUGHcardPassthroughobject with their server URL specified in thecardCallbackUrlfield- Other required parameters
For a full example, see Create a single online payment.
3. Customer opens the Vipps or MobilePay app​
The Widget SDK handles the transition from the website to the Vipps or MobilePay app automatically.
If the payment was started on a mobile device, the Vipps or MobilePay app opens automatically.
or MobilePay 
app opens
automatically.If the payment was started on a desktop device, a payment dialog opens. The customer enters their phone number and the payment request is sent to the app on their phone.
Screenshots showing the flow: 1. The merchant's checkout page with Vipps selected as the payment method. The dialog is not yet open. 2. A dialog showing a phone number entry form. The checkout page is visible and dimmed behind the dialog. 3. A dialog prompting the customer to open the Vipps app to complete the payment.
4. Customer selects a card and confirms​
The customer selects a card stored in their Vipps or MobilePay app and confirms the payment.
Screenshot: Vipps or MobilePay app payment screen showing the merchant name, order description, selected payment card, and a Pay button.
5. Vipps MobilePay sends the card token to the PSP​
Vipps MobilePay sends a card token to the PSP's server, specified as cardCallbackUrl in the create payment request.
See Card callback for the request format, HMAC authentication, and expected response.
6. The PSP processes the payment​
The PSP processes the payment through its own acquiring infrastructure using the card token.
The customer is then redirected to the merchant's returnUrl and sees the order confirmation.
7. The PSP updates the payment status​
The PSP captures, refunds, or cancels the payment via the ePayment API, keeping the Vipps MobilePay app status in sync.
More information​
For technical details, see the ePayment PSP API guide.