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

Для генерация Токена вам потребуется 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
}

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
}

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": "customer@gmail.com",
  "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"
}'

Last updated