Example: Vipps or MobilePay as Payment Agreement
To use Vipps or MobilePay as the payment method, set the paymentAgreementParameters as follows:
{
"paymentMethod": "Vipps",
"vippsMobilePayParameters": {
"customerPhoneNumber": "+4791234567",
"merchantAgreementUrl": "https://yourdomain.com/selfservice/vipps-agreement-info",
"merchantRedirectUrl": "https://yourdomain.com/order/complete",
"accountId": "your-account-id"
"profileScope": "name address email"
}
}
paymentMethodmust be set toVippsorMobilePay.vippsMobilePayParametersis an object with the following fields:customerPhoneNumber(optional): The phone number to pre-fill in the Vipps dialog.merchantAgreementUrl: URL to your self-service agreement page.merchantRedirectUrl: URL to redirect the user after approval/rejection in the Vipps app.profileScope(optional): Setting the profile scope will ask the user to share his/her contact details such as name, address, and email.
Example: SwedbankPay as Payment Agreement
To use SwedbankPay as the payment method, set the paymentAgreementParameters as follows:
{
"paymentMethod": "SwedbankPay",
"payExEcommerceParameters": {
"callbackUrl": "https://yourdomain.com/api/payment/callback",
"cancelUrl": "https://yourdomain.com/order/cancel",
"completeUrl": "https://yourdomain.com/order/complete",
"payExAccountId": "your-payex-account-id",
"culture": "nb-NO"
}
}
paymentMethodmust be set toSwedbankPay.payExEcommerceParametersis an object with the following fields:callbackUrl: URL for payment status callbacks from SwedbankPay.cancelUrl: URL to redirect the user if the payment is cancelled.completeUrl: URL to redirect the user after successful payment.payExAccountId(optional): The SwedbankPay account to use.culture(optional): Language/culture code for the payment window (e.g.,nb-NO).
Example: Mollie as Payment Agreement
To use Mollie as the payment method, set the paymentAgreementParameters as follows:
{
"paymentMethod": "Mollie",
"mollieParameters": {
"accountId": "945a996e-ac8b-4a96-96c3-deb136dc2830",
"returnUrl": "https://yourdomain.com/order/complete",
"cancelUrl": "https://yourdomain.com/order/cancel",
"culture": "nl-NL"
}
}
paymentMethodmust be set toMollie.mollieParametersis an object with the following fields:accountId: The Mollie account to use.returnUrl: URL to redirect the user back to after checkout.cancelUrl(optional): URL to redirect the user to if the checkout is cancelled.culture(optional): Mollie-compatible language/culture code for the checkout (for examplenl-NL).
Refer to the API documentation for additional options and required fields for other payment methods.