Платёжная ссылка закрывает многие продажи, но со временем бизнесу нужно больше: принимать оплату прямо на сайте, в приложении или из ERP, ничего не копируя вручную. Здесь на помощь приходит платёжный API.
Что такое платёжный API
API (программный интерфейс приложения) — это канал связи между вашей системой и платёжной платформой. С его помощью ваше ПО создаёт платежи, отслеживает их статус и автоматически получает подтверждения через HTTP-запросы с данными в формате JSON.
Как проходит интеграция: шаг за шагом
- Создайте аккаунт и получите ключи: в личном кабинете Sila Pay в меню API Key создаются ваши api-key и secret-key, которые передаются в заголовке каждого запроса.
- Создайте платёж: ваша система отправляет POST-запрос на https://api.silapay.pro/v1/transactions с суммой, данными клиента и способом оплаты (pix, creditCard или billet).
- Покажите оплату клиенту: для Pix ответ содержит код «копировать и вставить»; boleto выставляется с указанным сроком оплаты; по карте вы получаете результат транзакции.
- Получите подтверждение: укажите postbackUrl, и ваша система получит уведомление через вебхук при смене статуса платежа.
Pix, карта и boleto: в чём разница
- Pix: платёж создаётся со статусом «ожидает оплаты» и кодом «копировать и вставить»; подтверждение приходит через вебхук, как только оплата будет получена.
- Кредитная карта: поддерживается рассрочка — количество платежей указывается в запросе, — а клиента можно перенаправить на страницу успешной оплаты (successUrl).
- Boleto: вы задаёте срок оплаты и можете передать собственный идентификатор (externalReference), чтобы связать платёж с заказом.
Преимущества интеграции через API
- Вы управляете процессом: сами решаете, где и как клиент видит оплату.
- Меньше ручной работы: заказы создаются и подтверждаются автоматически.
- Одна интеграция — три способа оплаты: Pix, карта и boleto через один endpoint.
- Растёт вместе с бизнесом: один и тот же процесс подходит и для нескольких, и для множества заказов в день.
Хотите подключить платежи к своей системе? Откройте аккаунт в Sila Pay
Рекомендации по интеграции
- Ключи только на сервере: никогда не размещайте api-key и secret-key во фронтенде или в приложении; запросы должны идти с вашего бэкенда.
- Проверяйте вебхуки: сверяйте заголовок X-Silapay-Signature, прежде чем отмечать заказ как оплаченный.
- Сохраняйте ID транзакции: связывайте id, который возвращает API, с заказом в вашей системе.
- Обрабатывайте ошибки и тайм-ауты: показывайте понятное сообщение и позволяйте повторить попытку без дублирования платежа.
- Начните с небольших сумм: проверьте весь процесс, прежде чем открывать его для всех клиентов.
Частые вопросы
Нужен ли разработчик?
Для интеграции через API — да: кто-то должен запрограммировать запросы в вашей системе. Если вы используете WooCommerce или Shopify, проще воспользоваться плагинами Sila Pay, а без сайта подойдёт платёжная ссылка.
Где документация?
На doc.silapay.pro: там описаны запросы для Pix, карт, boleto, баланса и вебхуков, с примерами запросов и ответов.
API нужен только для приёма платежей?
Нет. Помимо создания платежей, в документации описаны отправка Pix (cash-out) и запрос баланса.
Нужна ли бразильская компания (CNPJ)?
В Sila Pay можно продавать как физическое или юридическое лицо; при регистрации указано, какие документы нужны в каждом случае.
Подключите Pix, карты и boleto через один API. Зарегистрируйтесь в Sila Pay