Skip to content

Сервис авторизации для получения JWT Bearer токена

Для аутентификации необходимо воспользолваться сервисом Auth v1 https://sapi.airbapay.kz/auth/swagger/index.html#/

Так же партнеру нужно реализовать сервис аутентификации для авторизации в сервис описанный выше. Описание сервиса аутентификации https://sapi.airbapay.kz/bg-proxy-general/swagger/index.html#/Partners/post_authenticate

Метод: POST

Адрес:

Тест: https://sapi.airbapay.kz/auth/api/v1/authenticate

Прод: https://api.airbapay.kz/auth/api/v1/authenticate

Креды для доступа userId, userSecret предоставляет команда AirbaPay

Сервис возвращает JWT токен. Вы можете его распарсить на сайте JSON Web Tokens - jwt.io. В нем содержится время жизни токена (UNIX time, seconds after epoch, согласно стандарту)

Структура запроса:

ПараметрТипОбязательно
userIdstringда
userSecretstringда

Тело запроса:

json
{
  "userId": "612799c9d72fbae710adfc9a",
  "userSecret": "secretValue"
}

Пример запроса:

curl -X POST "https://sapi.airbapay.kz/auth/api/v1/authenticate" -H "accept: application/json" -H "Content-Type: application/json" -d "{ \"userId\": \"3c455e0b-e28c-43a5-bb81-2c10d20dd2c9\", \"userSecret\": \"PflNgZnDJbVpe0I0f2i0PZIM2dOB6ukR\"}"

Структура ответа:

ПараметрТипОписание
accessTokenstringТокен
expiresInintСрок жизни токена в секундах
tokenTypestringТип токена

Пример ответа:

Заголовок 200, ОК

json
{
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzeXN0ZW0iOiJzaG9wX2R5c29uIiwiZXhwIjoxNjk2NTg1OTkzLCJzdWIiOiJicm9rZXItZ29vZHMifQ.9DbXyrh6NKI2FPLvqYM25UmgMAK1ARLXuzKejJqaY-I",
"expiresIn": 7200,
"tokenType": "bearer"
}

Отрицательные ответы:

Структура:

ПараметрТипОписание
statusstringСтатус ошибки
codeintКод ошибки
messagestringСообщение ошибки

Заголовок 400, Bad Request

json
{
    "error": {
        "status": "Invalid Credentials",
        "code": 401,
        "message": "userSecret not specified"
    }
}

При такой ошибке проверить название полей и структуру сообщения

Заголовок 401, Unauthorized

json
{
    "error": {
        "status": "Invalid Credentials",
        "code": 401,
        "message": "invalid userId or secret"
    }
}

При такой ошибке проверьте валидность username, password

Заголовок 500, Internal Server Error

json
{
    "error": {
        "code": 500,
        "message": "Internal Server Error",
        "status": "nil pointer dereference"
    }
}

При такой ошибке пробуйте заново или обратитесь за помощью к команде AirbaPay