First Step: Authenticate

To begin, you need to authenticate by calling the authentication endpoint:

curL

curl --location '<AUTH_BASE_URL/oauth2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'client_id=yourclientid' \
--data-urlencode 'client_secret=yourScrect' \
--data-urlencode 'grant_type=client_credentials'

Body

param
client_id	string	client_id provided by pay2free team
client_secrect	string	client_secret provided by pay2free team

Response

curl

{
    "access_token": "token",
    "expires_in": 3600,
    "token_type": "Bearer"
}

📘

Important

💡 The authentication token expires in 3600 seconds (60 minutes).

It is considered good practice to request a new token only when the current one expires to prevent rate limit request.

Now you're good to go!

Our product is divided into two parts:

KYC Simple: Returns only CPF (Brazilian individual taxpayer registry) information. Click here to learn more

Liveness: Liveness verification process Click here to learn more