Get Splitit Token

POST 
/token

To get a token, you will need your client_id and client_secret from your Merchant Hub. In your Merchant Hub, go to Merchants Management on the left-hand side. Click on your merchant name, then in the new window, go to Credentials on the left-hand side. Find your Username (which is client_id) and generate or use an existing Active Password (which is client_secret).

You can authenticate directly in the Request box on this page (at right). For grant_type, enter client_credentials, for scope type enter api.v1 api.v3, then enter your client_id and client_secret. Scroll down and press SEND API REQUEST. In the response, copy your access_token, which you can use to execute the other endpoints in this API reference.

• Note that unlike the other endpoints, your authentication payload should use the format application/x-www-form-urlencoded.

Request

application/x-www-form-urlencoded

Body

required

grant_typestring

i.e., client_credentials

scopestring

i.e. api.v1 api.v3

client_idstring

e.g., APIUser000032201

client_secretstring

e.g. sU9tOVHOcM6jPOjjWZpXZs4V0cmc01BZfChF5afrj71Dz2COn2

Responses

200

Success

application/json

Schema

Schema

access_tokenstring

The bearer token to add to your header

expires_ininteger

How long token will last

token_typestring

Type of token

scopestring

The scope granted to your request

Example (from schema)

{
  "access_token": "string",
  "expires_in": 0,
  "token_type": "string",
  "scope": "string"
}