Get Merchant Access Token

curl --request POST \
  --url https://api.revolv3.com/api/Authentication/token \
  --header 'Content-Type: application/json-patch+json' \
  --data '{
  "clientId": "clientIdentifier",
  "clientSecret": "clientSecret"
}'

{
  "token_type": "Bearer",
  "expires_in": 3599,
  "ext_expires_in": 3599,
  "access_token": "thisisagianttokenhash1NiIsImtpZCI6IlNzWnNCTmhaY0YzUTlTNHRycFFCVEJ5TlthisisagianttokenhashTQ0MTMiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vZjAyMzQ1MDEtMjdkZC00NTY1LWI1NDUtNDBlZDFmZjNjZDU1L3YyLjAiLCJpYXQiOjE1OTEyODthisisagianttokenhashhwIjoxNTkxMjkzODYzLCJhaW8iOiI0MmRnWURBTDhGTU5iNUgwOGF4thisisagianttokenhashYmExN2VkLTExMGMtNDVmthisisagianttokenhashmF6cGFjciI6IjEiLCJ0aWQiOiJmMDIzNDUwMS0yN2RkLTQ1NjUtYjU0NS00MGVkMWZmM2NkNTUiLCJ1dGkiOiJWOEhIbXVfZ1RVZUZQQ0pKNF91b0FBIiwidmVyIjoiMi4wIn0.rrQVOMQ2M3xhBeA96fOeidrghJep_DEC0-y-WTlsZu37rO18FgTBAp-tNeMasrLZlEcP6O2Ij8OqxY8yqxmIaPoaXpH9f8DN6nkthisisagianttokenhashlCDGp6zUdEb0XDA2-JXbSbs918g9DPBjuTDio1-Cithisisagianttokenhash8C4-H1XZfRN4Z7IMthisisagianttokenhashxp8lqK66NrXI2RtihtBs6gI3GKpfhok-H6_NvUaQQthisisagianttokenhashOHlKrKQ6D2fUIcXg",
  "isExpired": false,
  "expirationTime": "2025-10-31T13:48:18.7024109Z"
}

Authentication

Get Merchant Access Token

Generates an access token used to authenticate API requests on behalf of a specific merchant. This endpoint is typically called as part of the login or credential exchange process and requires valid client credentials (Merchant Client ID, Developer API Key), which can be generated in the Merchant Settings Profile page. The returned token should be included in the Authorization header of subsequent requests to secure endpoints. Access tokens are time-limited and may need to be refreshed once a year.

Related Links:

Merchant Access Token

curl --request POST \
  --url https://api.revolv3.com/api/Authentication/token \
  --header 'Content-Type: application/json-patch+json' \
  --data '{
  "clientId": "clientIdentifier",
  "clientSecret": "clientSecret"
}'

{
  "token_type": "Bearer",
  "expires_in": 3599,
  "ext_expires_in": 3599,
  "access_token": "thisisagianttokenhash1NiIsImtpZCI6IlNzWnNCTmhaY0YzUTlTNHRycFFCVEJ5TlthisisagianttokenhashTQ0MTMiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vZjAyMzQ1MDEtMjdkZC00NTY1LWI1NDUtNDBlZDFmZjNjZDU1L3YyLjAiLCJpYXQiOjE1OTEyODthisisagianttokenhashhwIjoxNTkxMjkzODYzLCJhaW8iOiI0MmRnWURBTDhGTU5iNUgwOGF4thisisagianttokenhashYmExN2VkLTExMGMtNDVmthisisagianttokenhashmF6cGFjciI6IjEiLCJ0aWQiOiJmMDIzNDUwMS0yN2RkLTQ1NjUtYjU0NS00MGVkMWZmM2NkNTUiLCJ1dGkiOiJWOEhIbXVfZ1RVZUZQQ0pKNF91b0FBIiwidmVyIjoiMi4wIn0.rrQVOMQ2M3xhBeA96fOeidrghJep_DEC0-y-WTlsZu37rO18FgTBAp-tNeMasrLZlEcP6O2Ij8OqxY8yqxmIaPoaXpH9f8DN6nkthisisagianttokenhashlCDGp6zUdEb0XDA2-JXbSbs918g9DPBjuTDio1-Cithisisagianttokenhash8C4-H1XZfRN4Z7IMthisisagianttokenhashxp8lqK66NrXI2RtihtBs6gI3GKpfhok-H6_NvUaQQthisisagianttokenhashOHlKrKQ6D2fUIcXg",
  "isExpired": false,
  "expirationTime": "2025-10-31T13:48:18.7024109Z"
}

Body

clientId

string

required

The client unique merchant identifier for authentication.

Minimum length: 1

clientSecret

string

required

The merchant's secret used to verify their identity.

Minimum length: 1

Response

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

tokenType

string

The token type, returns only Bearer.

expiresIn

integer

The remaining lifetime of the access token in seconds.

extExpiresIn

integer

The remaining lifetime of the access token in seconds.

accessToken

string

JWT token that must be included in the Authorization header.

isExpired

boolean

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.

Validate corporate ACH account Create Checkout Link

⌘I

AccountVerification

Authentication

Checkout

Customers

Invoices

MerchantOnboardings

PaymentMethod

Payments

Subscriptions

Get Merchant Access Token

Body

Response