Выплата
Пользователь инициирует платеж, после чего ожидает зачисление средств на свой счет. Непосредственное участие пользователя в процессе проведения выплаты не требуется.
| Регионы использования | Базово доступны: AT, BE, EE, ES, FI, FR, DE, GR, HU, IT, IE, LT, LV, NL, NO, PL, PT, RO, SE |
| Валюты выплаты | EUR |
| Суммы платежей | Информацию уточняйте у курирующего менеджера Openpayze. Также вы можете уточнить в Dashboard минимальную и максимальную сумму платежа, доступную в вашем проекте. |
| Время проведения платежа | Информацию уточняйте у курирующего менеджера Openpayze. |
| Конвертация валют | Информацию уточняйте у вашего курирующего менеджера Openpayze. |
| Возврат |  |
| Организация и стоимость подключения | По согласованию с курирующим менеджером Openpayze |
Основные операции
| Интерфейсы | |||
|---|---|---|---|
| Payment Page | Gate | Dashboard | |
| Выплата | |
 |
|
Уточнить минимальную и максимальную сумму платежа, доступную в вашем проекте, вы можете в Dashboard. Для этого в Dashboard перейдите в раздел Проекты и выберите вкладку Платежные методы.
Далее подробно рассказывается, что вам нужно делать для проведения платежа, а также о возможностях анализа уже проведенных платежей.
Выплата через Gate
Общая информация
Чтобы выполнить выплату через Gate с использованием метода Open Banking:
- Отправьте запрос с нужными параметрами и подписью на рабочий URL-адрес платежной платформы Openpayze.
- Примите от платежной платформы Openpayze оповещение (callback) с результатом выплаты.
Полная схема выплаты с использованием метода Open Banking выглядит следующим образом.
- Пользователь инициирует выплату с использованием метода Open Banking в вашей системе.
- Ваша система передает запрос на выплату в платежную платформу Openpayze.
- Платежная платформа отправляет вам ответ с информацией о получении запроса и о результате проверки его корректности. (Подробнее о формате ответа см. Формат ответа.)
- Платежная платформа обрабатывает запрос и отправляет его в сервис провайдера.
- Сервис провайдера оповещает платежную платформу о результате выплаты.
- Платежная платформа отправляет вам оповещение (callback) с результатом выплаты.
- Ваша система направляет пользователю информацию о результате выплаты.
Запрос
Далее представлена информация, необходимая для создания и отправки запроса на выплату с использованием метода Open Banking.
| HTTP-метод запроса | POST |
| Формат тела запроса | JSON |
| Конечная точка | /v2/payment/bank-transfer/world/payout |
| Полная спецификация конечной точки | /v2/payment/bank-transfer/{payment_method}/payout |
|
|||
|---|---|---|---|
| Объект | Параметр | Описание | |
general | project_id | Идентификатор проекта, полученный от Openpayze при интеграции. Пример: | |
payment_id | Идентификатор платежа, уникальный в рамках проекта. Пример: | ||
signature | Подпись запроса, составленная после определения всех параметров запроса. Подробнее о составлении подписи см. Использование подписи к данным. | ||
customer | id | Идентификатор пользователя, уникальный в рамках проекта. Пример: | |
ip_address | IP-адрес устройства пользователя. Пример: | ||
first_name | Имя пользователя. Имя пользователя должно совпадать с данными владельца банковского счета, в противном случае пользователь не сможет поулчить выплату. Пример: | ||
last_name | Фамилия пользователя. Фамилия пользователя должна совпадать с данными владельца банковского счета, в противном случае пользователь не сможет получить выплату. Пример: | ||
address | Адрес пользователя (улица, номер дома, номер корпуса, номер квартиры и т.п.). Пример: | ||
country | Страна пользователя в формате ISO 3166-1 alpha-2. Пример: | ||
account | number | Номер счета пользователя (IBAN). Пример: | |
bank_code | Буквенно-цифровой код (BIC/SWIFT) банка пользователя. Пример: | ||
payment | currency | Код валюты платежа в формате ISO-4217 alpha-3. Пример: | |
amount | Сумма платежа в дробных единицах валюты без десятичного разделителя (точки или запятой) и пробелов за исключением случаев, когда у валюты нет дробной части. Если у валюты нет дробных единиц (то есть количество разрядов дробных единиц равно нулю), то в этом параметре нужно указывать сумму в основных единицах валюты. Подробнее о разрядах дробных единиц у валют см. Использование дробных единиц валюты и Коды валют. Пример: 100,00 EUR передается как | ||
description | Описание платежа. Пример: | ||
| При необходимости добавьте в запрос необязательные параметры, указанные в спецификации Gate: API Reference. | |||
Вот пример тела запроса на выплату с использованием метода Open Banking:
{
"general": {
"project_id": 1234,
"payment_id": "payment_47",
"signature": "kUi2x9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y19vySO/RLUkDJrOcZzUCwX6R/ekpZhkIQg=="
},
"customer": {
"id": "customer_123",
"ip_address": "198.51.100.47",
"first_name": "John",
"last_name": "Doe",
"address": "4 Privet Drive",
"country": "GB"
},
"account": {
"number": "AB123456789012345678",
"bank_code": "AB123CDE456"
},
"payment": {
"currency": "EUR",
"amount": 10000,
"description": "Описание платежа."
}
}
Оповещение (callback)
В методе Open Banking результат выплаты платежная платформа возвращает в оповещении. Подробнее о структуре оповещений см. Оповещения.
Вот пример тела оповещения с информацией об успешно выполненной выплате:
{
"project_id": 1234,
"payment": {
"id": "payment_47",
"type": "payout",
"status": "success",
"date": "2024-12-07T19:08:45+0000",
"method": "world",
"sum": {
"amount": 10000,
"currency": "EUR"
},
"description": ""
},
"customer": {
"id": "customer_123"
},
"operation": {
"id": 47,
"type": "payout",
"status": "success",
"date": "2024-12-07T19:08:45+0000",
"created_date": "2024-12-07T19:08:05+0000",
"request_id": "1a23456bc7890de",
"sum_initial": {
"amount": 10000,
"currency": "EUR"
},
"sum_converted": {
"amount": 10000,
"currency": "EUR"
},
"code": "0",
"message": "Success",
"provider": {
"id": 12345,
"payment_id": "123abc123-123",
"auth_code": ""
}
},
"signature": "U7HQO7ToISZhMPKdM4XrUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}
Вот пример тела оповещения с информацией об отклоненной выплате.
{
"project_id": 1234,
"payment": {
"id": "payment_47",
"type": "payout",
"status": "decline",
"date": "2024-12-07T19:08:45+0000",
"method": "world",
"sum": {
"amount": 10000,
"currency": "EUR"
},
"description": ""
},
"customer": {
"id": "customer_123"
},
"operation": {
"id": 47,
"type": "payout",
"status": "decline",
"date": "2024-12-07T19:08:45+0000",
"created_date": "2024-12-07T19:08:05+0000",
"request_id": "1a23456bc7890de",
"sum_initial": {
"amount": 10000,
"currency": "EUR"
},
"sum_converted": {
"amount": 10000,
"currency": "EUR"
},
"code": "20000",
"message": "General decline",
"provider": {
"id": 12345,
"payment_id": "123abc123-123",
"auth_code": ""
}
},
"signature": "U7HQO7ToISZhMPKdM4XrUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}
Выплаты через Dashboard
При использовании интерфейса Dashboard можно проводить одиночные и массовые выплаты методом Open Banking с единичной и пакетной отправкой запросов, называемые соответственно одиночными и массовыми.
- Для проведения одиночной выплаты необходимо открыть форму выплаты, задать все необходимые параметры (включая метод), отправить запрос и убедиться в проведении выплаты.
-
Для проведения массовой выплаты необходимо подготовить и загрузить файл с информацией обо всех целевых выплатах, отправить пакет запросов и убедиться в проведении выплат.
При этом должен использоваться файл формата CSV, структура которого соответствует требованиям, представленным в разделе Сведения о массовых платежах, а параметры выплат — должны соответствовать требованиям, представленным в разделе Выплаты через Gate этой статьи (за исключением пункта о подписи).
Более подробная информация о проведении выплат через Dashboard представлена в отдельной статье.