Skip to main content
POST
Get Merchant Access Token

Headers

Client-Request-Id
string

Optional identifier generated by the client to match its own logs with this request.

Allowed values: 1 to 128 characters, letters, digits and ., _, :, -.

Examples: order-12345, 3f2b8c1e-9d4a-4e7b-a1c5-6b0d2e8f7a91 (GUID), checkout:2026-11-02.17, retry_1.order-12345.

A valid value is returned in the Client-Request-Id response header and is stored with Revolv3 request logs, so it can be used when contacting support. An invalid value is ignored and the request is processed normally. Do not send sensitive data in this header.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9._:-]{1,128}$

Body

clientId
string
required

The client unique merchant identifier for authentication.

Required string length: 1 - 500
clientSecret
string
required

The merchant's secret used to verify their identity.

Required string length: 1 - 500

Response

The credentials provided were valid, and a new access token has been successfully obtained.

token_type
string

The token type, returns only Bearer.

expires_in
integer<int32>

The remaining lifetime of the access token in seconds.

ext_expires_in
integer<int32>

The remaining lifetime of the access token in seconds.

access_token
string

JWT token that must be included in the Authorization header.

isExpired
boolean
read-only

Whether the token expired or not.

expirationTime
string<YYYY-MM-DDThh:mm:ss>

A timestamp expressed in UTC, indicating the exact moment the access token will expire.