Endpoints
Identify the calling Master Account
Returns the code and business name of the Master Account your bearer token maps to. Carries no internal ids and no token material. This is the natural smoke test for the whole authentication path.
Authorization
bearerAuth AuthorizationBearer <token>
A partner API token issued to a Master Account. Send Authorization: Bearer <token> on every request. Tokens are issued and revoked by a SuperAdmin in the backoffice, not through this API.
In: header
Response Body
application/json
application/json
application/json
{
"mastercode": "ACME",
"mastername": "Acme Payments (Pty) Ltd"
}{
"error": {
"code": "unauthorized",
"message": "A valid bearer token is required.",
"requestid": "8f3c1a9b2d7e4f60"
}
}{
"error": {
"code": "rate_limited",
"message": "Too many requests. Retry after the period indicated.",
"requestid": "8f3c1a9b2d7e4f60"
}
}