Freedom Pay

Link

POST

https://passport.freedompay.kz/api/v1/oauth/authorize

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string {{Username}}:{{Password}}

Example:

Authorization: Basic *****************

Body Params application/json

CLIENT_ID

string

required

Unique identifier for the partner, provided by Freedom ID support during integration.

CLIENT_SECRET

string

required

Secret key for the partner, provided by Freedom ID support during integration.

redirect_uri

string

required

The URL to which the user will be redirected after authentication.

grants

array[string]

required

Array of access permissions requested from the user. The array must be formatted as 'access level'.'access code'. A list of access codes is available in the reference guide. (example: read.phone)

Example

{
  "redirect_uri": "https://example.com/login",
  "grants": [
    "read.email",
    "read.phone",
    "read.date_of_birth",
    "read.firstname",
    "read.lastname",
    "read.gender",
    "read.nationality",
    "read.profile",
    "read.country"
  ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://passport.freedompay.kz/api/v1/oauth/authorize' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
  "redirect_uri": "https://example.com/login",
  "grants": [
    "read.email",
    "read.phone",
    "read.date_of_birth",
    "read.firstname",
    "read.lastname",
    "read.gender",
    "read.nationality",
    "read.profile",
    "read.country"
  ]
}'

Responses

🟢200Success

application/json

Body

redirect_uri

string

required

Example

{
  "redirect_uri": "https://passport.freedompay.kz/login?track_id=ac22c50c-22c7-4aeb-9160-e59b735f9c44&expire_at=1727246098"
}

🟢200Error

Modified at 2025-02-03 10:08:06

Error codes

Token