OAuth

Get OAuth2 access token

post

OAuth2 client credentials flow endpoint. Generate a new access token using client credentials. The "client_id" (username) and "client_secret" (password) must be passed as Basic Auth credentials. Ex: Authorization: Basic Base64Encode(client_id:client_secret). The returned access token should be used as Bearer token for subsequent API calls: Authorization: Bearer {access_token}

Authorizations

BasicAuth

AuthorizationstringRequired

Body

application/x-www-form-urlencoded

grant_typestringRequired

OAuth2 grant type - must be 'client_credentials'

Responses

200

Successfully generated OAuth2 access token

application/json

OAuth2 access token response structure containing the bearer token and expiration details

access_tokenstringOptional

@Description The OAuth2 access token for API authentication - use as Bearer token in Authorization header @Example 580defdbe1d21e0001c67e5c2a0a6c98ba8b4a059dc5825388501574

Example: 580defdbe1d21e0001c67e5c2a0a6c98ba8b4a059dc5825388501574

expires_inintegerOptional

@Description Token expiration time in seconds from issuance @Example 3600

Example: 3600

token_typestringOptional

@Description OAuth2 token type - always "bearer" for this implementation @Example bearer

Example: bearer

403

Invalid credentials

application/json

post

/oauth/token

HTTPcURLJavaScriptPython

POST /oauth/token HTTP/1.1
Host: public-api.alternativepayments.io
Authorization: Basic username:password
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 21

"grant_type='text'"

{
  "access_token": "580defdbe1d21e0001c67e5c2a0a6c98ba8b4a059dc5825388501574",
  "expires_in": 3600,
  "token_type": "bearer"
}