Генерация Токена доступа

Для генерация Токена вам потребуется Project ID и Project Secret, которые доступны после активация Проекта в maibmerchants.

Для Тестового Проекта Project ID и Project Secret будут доступны сразу после заполнения обязательных полей (IP, платформа, Callback URL, Ok URL, Fail URL).

Этапы аутентификации через Токен доступа

1. Отправьте запрос на эндпоинт генерации токена используя Project ID и Project Secret. Если переданные данные действительны, вы получите в ответ Токен (срок действия токена) и Refresh Token (срок действия Refresh Token).

2. Если срок действия токена истек, используйте Refresh Token, чтобы сгенерировать новый Токен доступа. Если срок действия Refresh Token также истек, используйте Project ID и Project Secret (см. пункт 1).

3. Делайте запросы к maib ecomm, используя Токен доступа.

1. Генерация токена с использованием Project ID и Project Secret

Параметры запроса (body)

Параметр	Обязательный	Тип	Описание
projectId	ДА	string	Project ID из Проекта в maibmerchants
projectSecret	ДА	string	Project Secret из Проекта в maibmerchants

Пример запроса (CURL)

curl --location --request POST "https://api.maibmerchants.md/v1/generate-token" \
    --header 'Content-Type: application/json' \
    --data-raw '{
    "projectId": "8508706",
    "projectSecret": "60462913-da44-47fa-8c82-146b676729b9"
    }'

Параметры ответа

Параметр	Тип	Описание
result	Object	Объект, содержащий Токен и Refresh Token.
accessToken	string	Токен доступа
expiresIn	integer	Время жизни Токена доступа в секундах
refreshToken	string	Refresh Token для генерация нового Токена доступа.
refreshExpiresIn	integer	Время жизни Refresh Token в секундах
tokenType	string	Тип токена (Bearer)
ok	Boolean	Статус обработки запроса: true - ошибок нет; false - есть ошибки (подробности ошибки будут отображаться в errors);
errors	Array	Ошибки обработки запроса
errorCode	string	Код ошибки
errorMessage	string	Описание ошибки

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

Без ошибок

"result": {
    "accessToken": "xxxxxx",
    "expiresIn": 300,
    "refreshToken": "xxxxxx",
    "refreshExpiresIn": 1800,
    "tokenType": "Bearer"
  },
  "ok": true
}

С ошибками

{
    "errors": [
        {
            "errorCode": "11001",
            "errorMessage": "Invalid credentials. Please check 'projectId' and 'projectSecret' parameters"
        }
    ],
    "ok": false
}

2. Генерация Токена с помощью Refresh Token

Параметры запроса (body)

Параметр	Обязательный	Тип	Описание
refreshToken	ДА	string	Refresh Token

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

curl --location --request POST "https://api.maibmerchants.md/v1/generate-token" \
    --header 'Content-Type: application/json' \
    --data-raw '{
    "refreshToken": "xxxxxxxxxxxxx"
    }'

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

Без ошибок

"result": {
    "accessToken": "xxxxxx",
    "expiresIn": 300,
    "refreshToken": "xxxxxx",
    "refreshExpiresIn": 1800,
    "tokenType": "Bearer"
  },
  "ok": true
}

С ошибками

{
    "errors": [
        {
            "errorCode": "11002",
            "errorMessage": "Invalid or expired 'refreshToken' parameter"
        }
    ],
    "ok": false
}

3. Пример запроса (прямой платеж) с аутентификацией через Токен

curl -X 'POST' \
  'https://api.maibmerchants.md/v1/pay' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer access_token' \
  -H 'Content-Type: application/json' \
  -d '{
  "clientIp": "135.250.245.121",
  "amount": 10.25,
  "currency": "MDL",
  "description": "Описание",
  "language": "ru",
  "orderId": "123",
  "clientName": "Имя Фамилия",
  "email": "[e-mail]",
  "phone": "069123456",
  "delivery": 1.25,
  "items": [
    {
      "id": "123",
      "name": "Product",
      "price": 2.5,
      "quantity": 2
    }
  ],
  "callbackUrl": "https://example.com/callback",
  "okUrl": "https://example.com/ok",
  "failUrl": "https://example.com/fail"
}'