Skip to main content

Recurring charges

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

Give your assistant up-to-date guidance for our APIs, with our plugin or without it.

The plugin is still under development. See the AI tools page for details.

Run both commands, in order.

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

For troubleshooting, see the full instructions.

A Recurring charge is a scheduled payment that happens at regular intervals (e.g., daily, weekly, monthly, yearly) as part of an active payment agreement.

Key features​

Flexible retries​

If a charge fails, the system can automatically retry—leading to up to 12% better conversion (i.e., more successful payments).

High conversion​

With retries, charge success rates can be as high as 96% or more.

Bulk charging​

You can process up to 2,000 charges in a single API request.

Rate limits​

Up to 500 requests per minute. Bulk charge creation is recommended if this rate limit is too low.

Lead time​

Charges are created by the merchant with a 1-day lead time and are processed on the requested due date. This provides greater flexibility and enables merchants and partners to create a charge until midnight before the due date.

API request snippet​

  • Merchants are aware of the due date and want Vipps MobilePay to handle the retry logic for failed payments.

    {
      "amount": 49900,
      "transactionType": "DIRECT_CAPTURE",
      "description": "Premium - January 2026",
      "due": "2026-01-01",
      "retryDays": 5,
      "type": "RECURRING"
    }

  • Merchants are aware of the due date for a payment but want to handle retry logic themselves for failed payments.

    {
      "amount": 49900,
      "transactionType": "DIRECT_CAPTURE",
      "description": "Premium - January 2026",
      "due": "2026-01-01",
      "retryDays": 0,
      "type": "RECURRING",
      "processingMode": "SINGLE_ATTEMPT"
    }

For more technical details, see API guide: Charges.

Last updated on