Skip to main content

Initial charge

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.

An initial charge (upfront payment) is a payment that users pay while signing up for a payment agreement. Only if the initial payment is successful, the agreement sign up is deemed successful. Commonly the initial payment is set to the same amount as the agreement pricing (or the campaign price if applicable), but you can also set it to a larger amount in case they need to pay an additional fee (i.e., the discounted price of the phone if they purchase a smartphone with a subscription). The payment agreement approval step in the sign-up flow is where the upfront payment amount is displayed to the user.

Tip

Initial charge can be used with any type of payment agreement and with campaigns.

Example industries/use-cases​

✨ Any subscription model that requires the user to pay an amount to start the subscription.

How it looks in the app​

Initial charge in Vipps

Screenshot: Two-screen payment agreement sign-up flow with an initial charge in the app (Vipps or MobilePay) — the overview step shows the recurring agreement details with an Accept/Confirm button; the approval step prominently displays the initial charge amount in large text along with an "Initial Charge Description" label, a payment card, and a Pay button.

API request snippet​

"initialCharge": {
  "amount": 5900,
  "currency": "NOK",
  "description": "Initial Charge for the subscription",
  "transactionType": "RESERVE_CAPTURE",
  "orderId": "merchant-order-1234"
}
Last updated on