ZovoPay Merchant API Docs
Company API Get API keys

Get Access Token

Exchange your API keys for a short-lived access token used to authorize the other endpoints.

POST {base_url}/authentication/token

Request body

ParameterTypeDescription
client_id requiredstringYour merchant API Client / Primary Key.
secret_id requiredstringYour merchant API Secret Key.

Example request

curl -X POST {base_url}/authentication/token \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{ "client_id": "YOUR_CLIENT_ID", "secret_id": "YOUR_SECRET_ID" }'

Success — 200 OK

{
  "message": { "code": 200, "success": ["SUCCESS"] },
  "data": {
    "access_token": "nyXPO8Re5SXP1c5gMqHbW6DQ5BfQ…",
    "expire_time": 600
  },
  "type": "success"
}

Error — 400

{
  "message": { "code": 400, "error": ["Invalid secret ID"] },
  "data": [],
  "type": "error"
}
⏱️ expire_time is the token lifetime in seconds (600 = 10 minutes). Re-use the token until it expires.