Skip to main content

Initial charge

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

Our plugin gives your assistant up-to-date guidance for payments and login. Full instructions

Run both commands, in order.

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

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 types of payment agreement and campaigns.

Example industries/use-cases​

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

How it looks in the app​

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