Skip to main content


The Checkout API should be considered an aggregation API of Vipps MobilePay services, while transaction operations is to be performed on the ePayment API. For examples of requests and responses, see the relevant API docs for Checkout and ePayment.

Checklist for full integration

Integrate all the Checkout API endpoints


Integrate applicable ePayment API endpoints

Get payment detailsGET:epayment/v1/{reference}
Cancel paymentPOST:epayment/v1/{reference}cancel
Full and partial capture paymentPOST:epayment/v1/{reference}/capture
Full and partial refund paymentPOST:epayment/v1/{reference}refund

Quality assurance

Handle callbacksCorrectly handle callbacks from Vipps, both for successful and unsuccessful payments. See the API documentation for how callback URLs are built, make test calls to make sure you handle the POST requests correctly. Vipps does not have capacity to manually do this for you.
Handle errorsMake sure to log and handle all errors. All integrations should display errors in a way that the users (customers and merchant employees/administrators) can see and understand them.
Include Vipps HTTP headersSend the Vipps HTTP headers in all API requests for better tracking and troubleshooting (mandatory for partners and platforms, who must send these headers as part of the checklist approval).
Add information to the payment historyWe recommend using the Order Management API to add receipts and/or images to the payment history. This is a great benefit for the end user experience. It is also mandatory for merchants using "Vipps Assisted Content Monitoring".

Avoid integration pitfalls

Send useful referenceFollow our reference recommendations.
Poll for payment detailsThe Merchant must not rely on fallback or callback alone, and must poll Payments Details GET:/epayment/v1/{reference} or Session Details GET:/checkout/v3/{reference} as documented (this is part of the first item in this checklist, but it's still a common error). For pure payment status polling the ePayment API is recommended. Follow our polling recommendations.
Handle redirectsThe merchant must handle that the fallback URL is opened in the default browser on the phone, and not in a specific browser, in a specific tab, in an embedded browser, requiring a session token, etc. Follow our recommendations regarding handling redirects. See the FAQ: How can I open the fallback URL in a specific (embedded) browser?
Follow design guidelinesThe Vipps branding must be according to the Vipps design guidelines.
Educate customer supportMake sure your customer service, etc. has all the tools and information they need available in your system, through the APIs listed in the first item in this checklist, and that they do not need to visit for normal work.