Skip to main content

Recurring API checklist


Download the Recurring API checklist as an editable PDF.

Partners only

Partners, please send your completed checklist to us at

Include your Merchant Serial Number, a short description of your solution, and the orderId used in your API requests, so we can verify your integration. We’ll get back with you as soon as possible.

We will verify your integration and get back to you as soon as possible.

Integrate all the API endpoints. For examples of requests and responses, see the Recurring API quick start guide.

Endpoints to integrateYour orderId
Agreement: Create an agreement - POST:/recurring/v3/agreementsnull
Agreement: Retrieve an agreement - GET:/recurring/v3/agreements/{agreementId}
Agreement: Update an agreement - PATCH:/recurring/v3/agreements/{agreementId}
Agreement: List charges - GET:/recurring/v3/agreements/{agreementId}/charges
Charge: Create Charge - POST:/recurring/v3/agreements/{agreementId}/charges
Charge: Retrieve a charge - GET:/recurring/v3/agreements/{agreementId}/charges/{chargeId}
Charge: Cancel a charge - DELETE:/recurring/v3/agreements/{agreementId}/charges/{chargeId}
Charge: Refund a charge - POST:/recurring/v3/agreements/{agreementId}/charges/{chargeId}/refund
Charge: Capture a reserved charge - POST:/recurring/v3/agreements/{agreementId}/charges/{chargeId}/capture
General integration pointersYour comments
Quality assurancenull
Handle errors
Monitor the error messages Vipps MobilePay returns from the APIs and correct problems as quickly as possible. It's recommended to log errors emitted by our APIs. This makes it easier to pinpoint what has gone wrong.
Include standard HTTP headers
Send the 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).
Avoid integration pitfalls
Poll for the agreement status
The Merchant must not rely on Redirect alone, but must always poll GET:/recurring/v3/agreements/{agreementId} to check the status of the agreement.
Provide subscription tools
The merchant must have a way for the user to manage and stop subscription in merchantAgreementUrl in their agreement. This should result in a timely update of the Vipps MobilePay Agreement.
Follow design guidelines
The Vipps MobilePay branding must be according to the design guidelines.
Educate customer support
Make 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.
Use at least two retryDays
The success rate of charges increases significantly when retryDays is set to two or more.

Download the Recurring API checklist as an editable PDF.

Flow to go live for direct integrations​

  1. Order Billing and Recurring Payments.
  2. We complete customer control (KYC, PEP, AML, etc.). The API keys for the production environment are made available on as soon as the customer control is completed, independently of this checklist.
  3. We notify you when you can retrieve your API keys.
  4. Complete all the checklist items.
  5. Verify the integration in the test environment by checking that there are test agreements and charges with your specified orderId in the test environment, with the following states:
    • A complete Agreement ending in ACTIVE.
    • A complete Agreement ending in STOPPED.
    • A complete "type":"RECURRING" Charge ending in CHARGED.
    • A complete "type":"RECURRING" Charge ending in REFUNDED.
  6. Start using the MSN and API keys in the production environment.
  7. Verify the integration in the production environment (similar to step 5).
  8. Partners only: Send your checklist to We don't do any kind of activation or make any changes based on this checklist, we just use it to verify that you have done the integration.
  9. Go live 🎉

Partners, see: Vipps MobilePay partners.

Friends high five

Help us improve our documentation

Did you find what you were looking for?