Mandarin

Mandarin API v1

Одна интеграция для финансовых маршрутов

Ваш код работает с клиентами, балансами и операциями Mandarin. Конкретного брокера, платёжного агента или сервиса выплат выбирает платформа.

Тестовый контур

Выдаваемые при регистрации ключи и реквизиты являются sandbox-данными. Реальные платежи не выполняются.

Авторизация

Передавайте ключ в заголовке каждого запроса. Полное значение показывается один раз в кабинете.

X-API-Key: mnd_test_••••••••.••••••••••••
01

Создайте клиента

curl https://api.mandarinex.io/v1/customers \
  -H "X-API-Key: $MANDARIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalCustomerId": "client-001",
    "type": "person"
  }'
02

Создайте пополнение RUB

`Idempotency-Key` защищает от случайного повторного создания операции.

curl https://api.mandarinex.io/v1/deposits \
  -H "X-API-Key: $MANDARIN_API_KEY" \
  -H "Idempotency-Key: order-001" \
  -H "Content-Type: application/json" \
  -d '{
    "creditOwner": {"type": "customer", "id": "CUSTOMER_UUID"},
    "money": {"amount": "10000.00", "asset": "RUB"},
    "partnerReference": "order-001"
  }'
03

Проверьте баланс

curl https://api.mandarinex.io/v1/customers/CUSTOMER_UUID/balances \
  -H "X-API-Key: $MANDARIN_API_KEY"

Создание пополнения не меняет баланс. RUB появляются только после подтверждённого расчёта.

Основные статусы

awaiting_funds
Реквизиты созданы, подтверждённого платежа нет.
processing
Операция обрабатывается внешним сервисом.
succeeded
Расчёт подтверждён, результат отражён в балансе.
failed
Операция завершилась ошибкой, баланс не зачислен.

Ошибки

API возвращает HTTP-статус и стабильный машинный код в поле `detail`. Повторяйте запрос с тем же `Idempotency-Key` только если тело запроса не менялось.

{"detail": "idempotency_conflict"}