Skip to main content

checkout-backend-merchant-v3.API (v3)

Download OpenAPI specification:Download

Session

Create a Checkout session

header Parameters
Vipps-System-Name
string <= 30 characters
Default: {{system_name}}
Example: Acme Commerce
Vipps-System-Version
string <= 30 characters
Default: {{system_version}}
Example: 3.1.2
Vipps-System-Plugin-Name
string <= 30 characters
Default: {{system_plugin_name}}
Example: acme-webshop
Vipps-System-Plugin-Version
string <= 30 characters
Default: {{system_plugin_version}}
Example: 4.5.6
client_id
string
Default: {{client_id}}
Example:
client_secret
string
Default: {{client_secret}}
Example:
Ocp-Apim-Subscription-Key
string
Default: {{Ocp-Apim-Subscription-Key}}
Example:
Merchant-Serial-Number
string
Default: {{merchantSerialNumber}}
Example:
Idempotency-Key
string
Default: {{Idempotency-Key}}
Example:
Request Body schema:
One of
required
object
object or null

If both dynamic and fixed options are specified, dynamic options is provided to the user. If no DynamicOptionsCallback is provided, only fixed logistics options will be used. When using dynamic shipping we recommend that you define logistics.fixedOptions as a backup. If the callback does not resolve successfully within 8 seconds, returns null or an empty list the system will fall back to static options. If no fallback options are provided, the user will be presented with an error and will not be able to continue with the checkout.

type
required
stringPAYMENT
Default: "PAYMENT"
object or null

Information about the customer to be prefilled

If any of the customer information is invalid such as the phone number, the customer will be prompted to input new user information.

required
object
object or null

Responses

Callbacks

Request samples

Content type
Example
{
  • "type": "PAYMENT",
  • "transaction": {
    },
  • "logistics": {
    },
  • "prefillCustomer": {
    },
  • "merchantInfo": {
    },
  • "configuration": {
    }
}

Response samples

Content type
application/json
{
  • "token": "string",
  • "checkoutFrontendUrl": "string",
  • "pollingUrl": "string"
}

Callback payload samples

Callback
Content type
application/json
{
  • "streetAddress": "string",
  • "postalCode": "string",
  • "region": "string",
  • "country": "string"
}

Get session info

Transaction information, user information and shipping information are included in the response if the SessionState is PaymentInitiated

path Parameters
reference
required
string
Default: "{{orderId}}"

The reference of the session. Example: "123123".

header Parameters
Vipps-System-Name
string <= 30 characters
Default: {{system_name}}
Example: Acme Commerce
Vipps-System-Version
string <= 30 characters
Default: {{system_version}}
Example: 3.1.2
Vipps-System-Plugin-Name
string <= 30 characters
Default: {{system_plugin_name}}
Example: acme-webshop
Vipps-System-Plugin-Version
string <= 30 characters
Default: {{system_plugin_version}}
Example: 4.5.6
client_id
string
Default: {{client_id}}
Example:
client_secret
string
Default: {{client_secret}}
Example:
Ocp-Apim-Subscription-Key
string
Default: {{Ocp-Apim-Subscription-Key}}
Example:
Merchant-Serial-Number
string
Default: {{merchantSerialNumber}}
Example:
Idempotency-Key
string
Default: {{Idempotency-Key}}
Example:

Responses

Response samples

Content type
application/json
{
  • "sessionId": "string",
  • "merchantSerialNumber": "string",
  • "reference": "string",
  • "sessionState": "SessionCreated",
  • "paymentMethod": "Wallet",
  • "subscriptionDetails": {
    },
  • "paymentDetails": {
    },
  • "userInfo": {
    },
  • "shippingDetails": {
    },
  • "billingDetails": {
    },
  • "customConsentProvided": true
}