Бразилия

Перед тем как начать

Авторизация

Как подписывать запросы API-токеном.

Обзор выплат

Общий формат запроса, поля ответа и статусы.

Это направление выплат доступно не всем мерчантам. Уточните доступность у вашего менеджера и убедитесь, что на вашем балансе мерчанта достаточно средств, прежде чем создавать выплату.

Обзор

Валюта	Направление	Типы платежа
`BRL`	PIX	`RANDOM`, `SIM`, `EMAIL`, `CPF`, `CNPJ`

Типы платежей

`paymentType`	Описание	Пример `account.requisites`
`RANDOM`	Случайный PIX-ключ	`super-uuid-secret`
`SIM`	Номер телефона	`+551113434354545`
`EMAIL`	Email	`email@example.com`
`CPF`	CPF (налоговый номер физического лица)	`12345678900`
`CNPJ`	CNPJ (налоговый номер юридического лица)	`12345678000200`

Поля `account`

Поле	Тип	Обязательное	Описание
`name`	string	✅ Да	Имя получателя
`requisites`	string	✅ Да	Реквизиты получателя: номер карты, номер телефона, PIX-ключ и т. д. в зависимости от `paymentType`
`userId`	string	✅ Да	ID пользователя в вашей системе

В requisites передаётся PIX-ключ того типа, который выбран в paymentType.

Пример запроса

curl -X POST "https://api.riopay.online/v1/payouts" \
  -H "Content-Type: application/json" \
  -H "X-Api-Token: YOUR_API_TOKEN" \
  -d '{
    "amount": 1000.50,
    "currency": "BRL",
    "paymentType": "EMAIL",
    "externalId": "payout-123",
    "account": {
      "name": "John Doe",
      "requisites": "john.doe@example.com",
      "userId": "user_12345"
    },
    "note": "Выплата по заказу №1234"
  }'