Метрики

GET /metrics — привязанные пользователи, выручка месяца, незакрытые выплаты.

Запрос

GET /api/v1/reseller/metrics
Authorization: Bearer rsk_<ключ>
200 OK
{
  "users_attributed": 432,
  "revenue_current_month": [
    { "currency": "RUB", "amount_cents": 12874500 },
    { "currency": "USD", "amount_cents": 4200 }
  ],
  "pending_payouts": [
    { "currency": "RUB", "amount_cents": 3862350 }
  ]
}
  • users_attributed — сколько аккаунтов привязано к вам всего.
  • revenue_current_month — успешные платежи ваших клиентов с начала текущего календарного месяца, по одной записи на валюту, в минорных единицах (копейки для RUB, центы для USD).
  • pending_payouts — то же по строкам выплат в статусе pending.

Пустой список — это ответ, а не ошибка: денег в этой валюте пока не было.

Почему это список, а не число

Потому что суммировать рубли с долларами нельзя, а раньше мы именно это и делали — складывали всё в одно поле и подписывали его USD. Для партнёра с рублёвым прайсом число получалось завышенным примерно в девяносто раз. Складывайте только внутри валюты; между валютами — не складывайте вообще.

Требуется скоуп metrics:read.

Ограничения

  • Разбивки по планам и оттока здесь нет. Тренды и разрез по клиентам — в кабинете, на дашборде; график рисуется по одной валюте (по умолчанию той, в которой у вас больше выручки, параметр ?currency= переключает).
  • Значения считаются на лету по базе, кэша на нашей стороне нет. Опрашивайте не чаще раза в несколько минут.