Что это
Stripe API - программный интерфейс платежных продуктов Stripe. Через него приложение работает с платежными намерениями PaymentIntent, клиентами, счетами и подписками. Для конкретного сценария выбирают нужные объекты и разрешения, а не универсальный доступ ко всем финансовым действиям.
API полезен, когда магазин должен проверить состояние платежа или передать событие в учетную систему. Он не является ИИ-моделью и не заменяет проверку заказа. Возврат, списание и изменение подписки - отдельные действия с реальными последствиями.
Первый тест делайте в sandbox: прочитайте список учебных PaymentIntent и сверяйте их статусы. Не используйте рабочий secret key и не создавайте реальные списания для знакомства с API.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Платежи, клиенты, счета и подписки представлены отдельными объектами API.
- Sandbox позволяет проверять сценарии без движения реальных денег.
- Restricted keys помогают ограничить права интеграции.
- Webhooks позволяют получать изменения состояния, а не опираться только на экран клиента.
Ограничения
- Рабочий доступ зависит от страны бизнеса, проверки аккаунта и продукта.
- Статусы PaymentIntent нужно трактовать отдельно от создания объекта.
- События могут повторяться и приходить не в ожидаемом порядке.
- Комиссии, лимиты и операции зависят от выбранного продукта и условий аккаунта.
Как использовать
1. Подготовка. Проверьте поддерживаемую страну бизнеса и доступ аккаунта. Откройте sandbox; нужны только учебные данные. В нем можно подготовить тестовый PaymentIntent через официальный тестовый сценарий, без настоящей карты.
2. Настройка. Создайте sandbox restricted key с чтением PaymentIntents, остальные права оставьте отключенными. Сохраните ключ на сервере или в окружении STRIPE_READ_KEY. Зафиксируйте API-версию интеграции и используйте документацию этой версии.
3. Первый результат. В PowerShell выполните curl.exe -G https://api.stripe.com/v1/payment_intents -u "$($env:STRIPE_READ_KEY):" -d limit=3; в другом shell используйте его синтаксис переменных. Для каждой записи выведите только id, status, amount и currency. Пустой data означает отсутствие учебных записей в выбранной среде, не ошибку оплаты.
4. Проверка. Сверьте одну запись с sandbox Dashboard и убедитесь, что livemode равно false. Проверьте API-ошибки и has_more; следующие страницы получают через starting_after. Перед рабочим запуском проверяйте подписи webhooks и исключайте дубли. Для разрешенных POST-операций используйте Idempotency-Key и отдельное согласование, а не повторное списание после сбоя.
Примеры сценариев
- Показать оператору статус конкретного учебного платежа.
- Передать разрешенное событие оплаты в учетную систему.
- Проверить, почему созданный платеж еще требует действия.
Доступ и оплата
- Модель оплаты: Оплата по использованию
- Бесплатный тариф: Нет
- Пробный доступ: Да
- Работа в РФ: Ограниченно
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
В официальном списке стран Stripe Payments Россия не указана. Это ограничение подключения бизнеса, а не задача, решаемая VPN. Для аккаунта в поддерживаемой стране отдельно проверьте допустимость вашей деятельности; тарифы зависят от страны и продуктов. Sandbox не является бесплатным рабочим приемом платежей.
Когда не подходит
- Гарантировать подключение бизнеса из любой страны
- Считать созданный PaymentIntent уже оплаченным
- Разрешить модели самостоятельно делать возвраты
Альтернативы
YooKassa API - вариант платежной интеграции для подходящего российского бизнеса. Stripe Finance API на ezGPT описывает чтение и сверку данных того же Stripe API. QuickBooks Online API нужен для учета, не прямой замены приема платежей.