Authentication

The Fiat Republic API uses the OAuth 2.0 client credentials authentication flow and requires a Bearer Token to authenticate requests. All API calls must include a bearer token in the Authorization header.

You can create your API key from the Developers section on the Dashboard.

❗️

Store your Auth Key

After generating your keys, a modal will appear displaying your Secret Key.

It's crucial to store this key securely, as you won't be able to retrieve it once you leave this page.

To get an access token, send your Client ID, Client Secret, and the required Scope (which defines the permissions your token will have) in the request body of the Create Create API Token endpoint.

You will also be required to provide the following scope:

• PAYMENTS

curl --location 'https://sandbox.fiatrepublic.com/passport/oauth/token' \
--header 'Accept: application/json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'scope=PAYMENTS' \
--data-urlencode 'client_id=your_client_id' \
--data-urlencode 'client_secret=your_client_secret'

{
   "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJI...",
   "token_type": "bearer",
   "expires_in": 3599
}