Get token - Freedom Pay

Token-Based Authentication
Access to the API is controlled through access tokens and refresh tokens, ensuring secure communication and limiting unauthorized usage.

Description: This method is used to authenticate an agent in the IMTS system. The agent transmits its credentials (agent_ID) and (agent_secret) and receives an access token and a refresh token.

Important
The access token is required to perform all operations related to transfers.
The refresh token is used to extend the session without the need to re-enter credentials.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
    "state": true,
    "response_time": "2025-07-23T11:17:31.577745Z",
    "payload": {
        "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJpbXRzLWFwaSIsImF1ZCI6ImltdHMtYmFja2VuZCIsImp0aSI6IjBmYThmMzM0ZWNkZWFiYzNkNjE3NTc4Yjk0ODBmMTk5IiwiaWF0IjoxNzUzMjY5NDUxLjU3MjkxLCJuYmYiOjE3NTMyNjk0NTEuNTcyOTEsImV4cCI6MTc1MzI3MDM1MS41NzI5NjQsInN1YiI6IjEiLCJ0eXBlIjoiYWNjZXNzX3Rva2VuIiwiYWdlbnRfaWQiOiIxIn0.z3vHVKE2u_W9AR-aqG02r6vJqwkMDxrq03LzUDqfinc",
        "refresh_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJpbXRzLWFwaSIsImF1ZCI6ImltdHMtYmFja2VuZCIsImp0aSI6ImU3M2I3OTBiYzM3ODFlZjQ0MGIxNzg0NTUxNzBmODgyIiwiaWF0IjoxNzUzMjY5NDUxLjU3MjkxLCJuYmYiOjE3NTMyNjk0NTEuNTcyOTEsImV4cCI6MTc1NTg2MTQ1MS41NzMyNTksInN1YiI6IjEiLCJ0eXBlIjoicmVmcmVzaF90b2tlbiIsImFnZW50X2lkIjoiMSJ9.KaWOD4g0gW5y_TaCmtt7smC9JCweLbHClYOyvQpbKEY",
        "access_expire_at": "2025-07-23T11:32:31+00:00",
        "refresh_expire_at": "2025-08-22T11:17:31+00:00"
    }
}