Authentication

Each API request must contain an authorization header in the following format to make a call: Bearer <your_access_token>.

Do not ever share your access tokens, JWT tokens, as these can be used to access your payments data and initiate transactions, refunds, and others.

In order to generate your access token, you need to follow the following process.

1. Generate a private and a public certificate​

2. Upload your public key in your account

3. Create a JWT token using your private key

4. Use your company id as your client_id, and set the Authorization header as Bearer ${jwt}

5. Use the /v1/oauth/token endpoint to request the access_token in order to access the system.

Obtain Access Token

post

https://api.brouwervos.nlhttps://staging.api.brouwervos.nl

/v1/oauth/token

Retrieve an access token using client credentials.

Authorizations

bearerAuth

Body

application/x-www-form-urlencoded

grant_typestringRequired

The type of grant request (e.g., 'client_credentials').

client_idstringRequired

The client identifier issued to the client.

Responses

200

Access token successfully obtained.

application/json

access_tokenstringOptional

The access token issued by the authorization server.

token_typestringOptional

The type of the token issued (typically 'Bearer').

expires_ininteger · int32Optional

The lifetime in seconds of the access token.

400

Invalid request parameters.

401

Unauthorized - Invalid client credentials.

post

/v1/oauth/token

HTTPcURLJavaScriptPython

POST /v1/oauth/token HTTP/1.1
Host: api.brouwervos.nl
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 40

"grant_type='text'&client_id='text'"

{
  "access_token": "text",
  "token_type": "text",
  "expires_in": 1
}