Skip to content
/Access Keys

Access Keys

OAuth access keys are created in Merchant Dashboard and can be exchanged for bearer tokens.

Use the /access-keys/token endpoint to mint a bearer token from a valid client_id and client_secret.

Operations

Mint an access token

Request

Exchange an OAuth access key for a bearer token by providing its client_id and client_secret in the request body.

Bodyapplication/jsonrequired
client_idstringrequired

OAuth access key client ID returned when the access key was created.

client_secretstringrequired

OAuth access key client secret returned when the access key was created or rotated.

curl -i -X POST \
  https://docs.resolvepay.com/_mock/partners-api/openapi/access-keys/token \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "abc123clientid",
    "client_secret": "secret-value"
  }'

Responses

Successfully minted bearer token

Bodyapplication/json
access_tokenstringrequired

Bearer token to include in the Authorization header.

token_typestringrequired
Example:"Bearer"
expires_inintegerrequired

Token lifetime in seconds.

Example:86400
scopestring

Space-delimited scopes granted to the token.

Example:"merchant:read merchant:write"
Response
{
  "access_token": "eyJ...",
  "token_type": "Bearer",
  "expires_in": 86400,
  "scope": "merchant:read merchant:write"
}