Пополнение картой

Пополнение картой позволяет вам пополнить аккаунт Yoyo Market (далее — Yoyo), переведя RUB с вашей банковской карты на карту платформы. Оператор платформы подтверждает платеж и зачисляет ваш баланс. Комиссия — 0%.

Как это работает

1. Проверка лимитов и реквизитов карты

Перед созданием ордера получите реквизиты карты платформы и лимиты пополнения:

GET /api/v1/card/limits

Ответ:

{
  "platform_card": {
    "bank_name": "...",
    "card_number": "...",
    "holder_name": "..."
  },
  "min_amount_kopecks": 10000,
  "max_amount_kopecks": 5000000
}

• platform_card — реквизиты банковской карты, на которую нужно отправить перевод.
• min_amount_kopecks / max_amount_kopecks — допустимый диапазон пополнения в копейках (100 копеек = 1 RUB).

2. Создание ордера на пополнение

POST /api/v1/card/orders

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

{
  "type": "deposit",
  "amount_kopecks": 500000
}

• type — должен быть "deposit".
• amount_kopecks — сумма пополнения в копейках (например, 500000 = 5,000 RUB).

Ответ:

{
  "id": 42
}

Ордер создается со статусом pending.

3. Перевод средств

С помощью банковского приложения переведите указанную сумму на карту платформы, показанную в ответе /card/limits. Убедитесь, что сумма совпадает точно.

4. Подтверждение оплаты

После отправки перевода отметьте ордер как оплаченный:

POST /api/v1/card/orders/{id}/confirm-paid

Это переводит статус ордера из pending в paid_by_user. Оператор платформы получает уведомление.

5. Подтверждение получения оператором

Оператор платформы проверяет свой банковский счет на предмет входящего перевода. После подтверждения оператор отмечает ордер как завершенный, и ваш баланс зачисляется на сумму пополнения.

Поток статусов ордера

pending  -->  paid_by_user  -->  completed
   |
   +--> cancelled (пользователем или оператором)

Статус	Описание
pending	Ордер создан, ожидается банковский перевод
paid_by_user	Вы подтвердили оплату, оператор проверяет
completed	Оператор подтвердил получение, баланс зачислен
cancelled	Ордер отменен до завершения

Чат с оператором

Каждый ордер на карту имеет интегрированный чат. Если у вас есть вопросы или нужно решить проблему:

Отправить сообщение:

POST /api/v1/card/orders/{id}/messages

{
  "message": "I sent the transfer, receipt attached."
}

Прочитать сообщения:

GET /api/v1/card/orders/{id}/messages?limit=50&offset=0

Просмотр ваших ордеров

GET /api/v1/card/orders/my?type=deposit&status=pending&limit=20&offset=0

Все параметры запроса необязательны. Фильтруйте по type (deposit или withdraw) и status (pending, paid_by_user, completed, cancelled).

Отмена ордера

Вы можете отменить ордер, пока он в статусе pending:

POST /api/v1/card/orders/{id}/cancel

После подтверждения оплаты (статус paid_by_user) для отмены требуется вмешательство оператора.

Коды ошибок

Код	Описание
AMOUNT_TOO_LOW	Сумма ниже минимального лимита пополнения
AMOUNT_TOO_HIGH	Сумма превышает максимальный лимит пополнения
ACTIVE_ORDER_EXISTS	У вас уже есть активный ордер на карту этого типа
CARD_DISABLED	Карточные платежи временно недоступны