Бразилия
Оплата через PIX по QR-коду в BRL
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Создание платежа
Базовый запрос на создание заказа, который расширяет эта страница.
Этот способ оплаты доступен не всем мерчантам. Уточните доступность у вашего менеджера.
Обзор
| Валюта | Способ оплаты | Схема |
|---|---|---|
BRL | PIX (QR-код) | Вы запрашиваете QR-ссылку и сами показываете её плательщику |
Это схема host-to-host: вы получаете QR-ссылку PIX напрямую из API и отображаете её в собственном интерфейсе.
Схема работы
Запросите QR-ссылку
POST /v1/orders/{orderId}/h2h/pixcurl -X POST "https://api.riopay.online/v1/orders/{orderId}/h2h/pix" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN"QR-ссылка генерируется на стороне провайдера. Установите таймаут запроса от 30 секунд.
Ответ:
{
"qrLink": "https://pix.com.br/..."
}Покажите QR-код
Отобразите qrLink в виде QR-кода или откройте его как ссылку на мобильных устройствах. Плательщик подтверждает перевод в приложении своего банка.
Дождитесь результата
Статус заказа меняется на COMPLETED, когда перевод подтверждён. Вы получаете webhook или можете опрашивать заказ по ID.
Статус заказа и webhook-уведомления
Статусы заказа
| Статус | Финальный | Описание |
|---|---|---|
CREATED | Нет | Заказ создан, платёжная ссылка ещё не открыта |
PENDING | Нет | Ожидает оплаты |
COMPLETED | Да | Платёж успешно завершён, средства получены |
FAILED | Условно | Ошибка оплаты |
CANCELED | Условно | Заказ отменён системой |
EXPIRED | Условно | Срок действия заказа истёк до оплаты |
BLOCKED | Условно | Транзакция заблокирована банком |
REFUND | Да | Платёж возвращён плательщику. Устанавливается после COMPLETED |
CHARGEBACK | Да | Платёж оспорен плательщиком и отменён банком. Устанавливается после COMPLETED |
FAILED, CANCELED, EXPIRED и BLOCKED не являются строго финальными. Если банк позже подтверждает платёж из-за ошибки на своей стороне, заказ переходит в COMPLETED, и webhook-уведомление об этом отправляется автоматически. Будьте готовы получить COMPLETED по заказу, который вы уже отметили как неуспешный.