Что это
Название Stripe Finance API используется на ezGPT для финансовых сценариев обычного Stripe API. Это не отдельный официальный продукт с собственной подпиской и не банковский Stripe Treasury. Здесь основной предмет - чтение и сверка записей BalanceTransaction.
Такая запись показывает влияние операции на баланс: исходную сумму amount, комиссию fee, итог net, валюту и источник. Это помогает отличить оборот от суммы после комиссий и объяснить расхождение между отчетом магазина и Stripe.
Отчет должен учитывать период, валюту и виды операций. Нельзя считать все записи продажами или складывать разные валюты в одну сумму. Для первого результата используйте sandbox и только чтение; решения о возвратах и бухгалтерской классификации оставьте ответственному специалисту.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- BalanceTransaction показывает amount, fee и net одной операции.
- source связывает финансовую запись с исходным объектом Stripe.
- Фильтры и пагинация помогают собрать ограниченную выгрузку.
- Финансовый отчет можно отделить от прав создания возвратов и выплат.
Ограничения
- Название карточки не соответствует отдельному официальному API-продукту.
- Выгрузка может содержать возвраты, комиссии и другие операции, не только продажи.
- Разные валюты, периоды и статусы требуют отдельной сверки.
- Движение баланса Stripe не равно банковской выписке или готовой проводке.
Как использовать
1. Подготовка. Выберите sandbox и учебные операции. Задайте период и одну валюту отчета, договоритесь, какие типы операций включать. Если sandbox пустой, подготовьте тестовую оплату по официальной инструкции без движения реальных денег.
2. Настройка. Создайте sandbox restricted key с необходимым чтением Balance/Balance transactions и без записи, возвратов и выплат. Сохраните его в STRIPE_READ_KEY на сервере. Проверьте разрешения фактическим запросом и зафиксируйте API-версию.
3. Первый результат. Получите GET https://api.stripe.com/v1/balance_transactions?limit=3 с HTTP Basic Auth: ключ как имя пользователя, пароль пустой. Для каждой записи выведите id, amount, fee, net, currency, type, status и source. Сохраните сумму в минимальных единицах валюты, без универсального деления на 100.
4. Проверка. Для одной записи проверьте net = amount - fee и сопоставьте source с операцией в sandbox Dashboard. available и pending относятся к балансу Stripe, не банковской выписке. Пройдите has_more/starting_after, затем сверяйте полный выбранный период по каждой валюте и типу отдельно. Пустой список не заполняйте выдуманными операциями.
Примеры сценариев
- Показать, как комиссия меняет сумму после оплаты.
- Найти операцию, объясняющую расхождение отчета.
- Подготовить раздельную сводку продаж и возвратов по одной валюте.
Доступ и оплата
- Модель оплаты: Оплата по использованию
- Бесплатный тариф: Нет
- Пробный доступ: Да
- Работа в РФ: Ограниченно
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Применяются условия обычного аккаунта и продуктов Stripe, отдельного тарифа Finance API здесь нет. Россия не указана среди стран подключения Stripe Payments. Наличие test-доступа не подтверждает возможность рабочего приема платежей или выплат для конкретного бизнеса.
Когда не подходит
- Получить отдельный банковский продукт по названию карточки
- Подменять сверкой полную бухгалтерию
- Считать pending уже поступившими деньгами на банковский счет
Альтернативы
Stripe API описывает общую платежную интеграцию. Xero Accounting API и QuickBooks Online API работают с учетными системами; они не заменяют исходные данные Stripe. Для сверки банка нужна отдельная выписка и сопоставление, а не только BalanceTransaction.
