Skip to main content
API docs by Redocly

Webhooks API (v1)

Download OpenAPI specification:Download

The Webhooks API enables you to get HTTP notifications for subscribed events. See the Webhooks API guide for more details.

v1

Get all registered webhooks

Authorizations:
Bearer-Authorization
header Parameters
Ocp-Apim-Subscription-Key
required
string
Example: da7d5b0e18a84aeda961c0c31b75c2a9

The subscription key

Merchant-Serial-Number
string
Example: 654321

The Merchant Serial Number (MSN) is a unique ID for the sale unit that this payment is made for. This is a required parameter if you are a partner making payments on behalf of a merchant. The partner must use the merchant's MSN (not the partner's MSN). This parameter is optional, and recommended, for regular Vipps merchants making payments for themselves.

Vipps-System-Name
string <= 30 characters
Example: woocommerce

The name of the ecommerce solution. One word in lowercase letters is good. See HTTP headers.

Vipps-System-Version
string <= 30 characters
Example: 5.4.0

The version number of the ecommerce solution. See HTTP headers.

Vipps-System-Plugin-Name
string <= 30 characters
Example: vipps-woocommerce

The name of the ecommerce plugin (if applicable). One word in lowercase letters is good. See HTTP headers.

Vipps-System-Plugin-Version
string <= 30 characters
Example: 1.2.1

The version number of the ecommerce plugin (if applicable). See HTTP headers.

Responses

Response samples

Content type
application/json
{
  • "webhooks": [
    ]
}

Register webhook

Register a new webhook. There is a limit to the number of webhooks that can be registered per event, see the API guide for more information.

Authorizations:
Bearer-Authorization
header Parameters
Ocp-Apim-Subscription-Key
required
string
Example: da7d5b0e18a84aeda961c0c31b75c2a9

The subscription key. See API keys.

Merchant-Serial-Number
string
Example: 654321

The Merchant Serial Number (MSN) is a unique ID for the sale unit that this payment is made for. This is a required parameter if you are a partner making payments on behalf of a merchant. The partner must use the merchant's MSN (not the partner's MSN). This parameter is optional, and recommended, for regular Vipps merchants making payments for themselves.

Vipps-System-Name
string <= 30 characters
Example: woocommerce

The name of the ecommerce solution. One word in lowercase letters is good. See HTTP headers.

Vipps-System-Version
string <= 30 characters
Example: 5.4.0

The version number of the ecommerce solution. See HTTP headers.

Vipps-System-Plugin-Name
string <= 30 characters
Example: vipps-woocommerce

The name of the ecommerce plugin (if applicable). One word in lowercase letters is good. See HTTP headers.

Vipps-System-Plugin-Version
string <= 30 characters
Example: 1.2.1

The version number of the ecommerce plugin (if applicable). See HTTP headers.

Request Body schema: application/json
required
url
required
string <uri>

The URL that updates should be sent to. Must be a valid, world-reachable URL. The URL must use HTTPS. The URL must respond with a 2XX HTTP status code, like HTTP 200 OK. Can not be a URL that redirects to a different URL. We don't send requests to all ports, so to be safe use common ports such as: 80, 443, 8080.

events
required
Array of strings

See Webhooks API Events for details.

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "secret": "090a478d-37ff-4e77-970e-d457aeb26a3a"
}

Delete a webhook

Authorizations:
Bearer-Authorization
path Parameters
id
required
string <uuid>
header Parameters
Ocp-Apim-Subscription-Key
required
string
Example: da7d5b0e18a84aeda961c0c31b75c2a9

The subscription key

Merchant-Serial-Number
string
Example: 654321

The Merchant Serial Number (MSN) is a unique ID for the sale unit that this payment is made for. This is a required parameter if you are a partner making payments on behalf of a merchant. The partner must use the merchant's MSN (not the partner's MSN). This parameter is optional, and recommended, for regular Vipps merchants making payments for themselves.

Vipps-System-Name
string <= 30 characters
Example: woocommerce

The name of the ecommerce solution. One word in lowercase letters is good. See HTTP headers.

Vipps-System-Version
string <= 30 characters
Example: 5.4.0

The version number of the ecommerce solution. See HTTP headers.

Vipps-System-Plugin-Name
string <= 30 characters
Example: vipps-woocommerce

The name of the ecommerce plugin (if applicable). One word in lowercase letters is good. See HTTP headers.

Vipps-System-Plugin-Version
string <= 30 characters
Example: 1.2.1

The version number of the ecommerce plugin (if applicable). See HTTP headers.

Responses

Response samples

Content type
application/problem+json
{
  • "type": "00-bb841c551513e233de8a01472013fa9f-542c71e40916a6ce-00",
  • "title": "Bad Request",
  • "status": 400,
  • "detail": "One or more validation errors occurred.",
  • "instance": "/v1/webhooks",
  • "traceId": "00-bb841c551513e233de8a01472013fa9f-542c71e40916a6ce-00",
  • "extraDetails": [
    ]
}