Общее

Платёжный API: как подключить Pix, карты и boleto к вашей системе

Руководство по платёжному API: что это, как проходит интеграция и как принимать оплату через Pix, кредитной картой и boleto в Бразилии прямо с сайта, из приложения или вашей системы.

Автор: Equipe Sila Pay3 мин чтения
Двое улыбающихся коллег беседуют рядом с ноутбуком в небольшом офисе

Платёжная ссылка закрывает многие продажи, но со временем бизнесу нужно больше: принимать оплату прямо на сайте, в приложении или из ERP, ничего не копируя вручную. Здесь на помощь приходит платёжный API.

Что такое платёжный API

API (программный интерфейс приложения) — это канал связи между вашей системой и платёжной платформой. С его помощью ваше ПО создаёт платежи, отслеживает их статус и автоматически получает подтверждения через HTTP-запросы с данными в формате JSON.

Как проходит интеграция: шаг за шагом

  1. Создайте аккаунт и получите ключи: в личном кабинете Sila Pay в меню API Key создаются ваши api-key и secret-key, которые передаются в заголовке каждого запроса.
  2. Создайте платёж: ваша система отправляет POST-запрос на https://api.silapay.pro/v1/transactions с суммой, данными клиента и способом оплаты (pix, creditCard или billet).
  3. Покажите оплату клиенту: для Pix ответ содержит код «копировать и вставить»; boleto выставляется с указанным сроком оплаты; по карте вы получаете результат транзакции.
  4. Получите подтверждение: укажите 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

#pagamentos#vendas online
ПоделитьсяWhatsAppLinkedInX

Готовы применить это на практике?

Создайте аккаунт Sila Pay за несколько минут и принимайте оплату через Pix, карты и платёжные ссылки.

  • ✓ Бесплатная регистрация
  • ✓ Без абонентской платы
  • ✓ Зачисление в D+1
Создать бесплатный аккаунт →

Получайте новые статьи

Практичные материалы о платежах и онлайн-продажах прямо на вашу почту.

Без спама. Отписаться можно в любой момент.

Читайте также

Sila Pay

Всё, что нужно для продаж, в одном месте.

Начать →