Выплата
Пользователь инициирует платеж, после чего ожидает зачисление средств на свой счет. Непосредственное участие пользователя в процессе проведения выплаты не требуется.
| Регионы использования | Турция |
| Валюты выплаты | TRY |
| Суммы платежей | Информацию уточняйте у курирующего менеджера Flashpay. Также вы можете уточнить в Dashboard минимальную и максимальную сумму платежа, доступную в вашем проекте. |
| Время проведения платежа | Информацию уточняйте у курирующего менеджера Flashpay. |
| Конвертация валют | На стороне Flashpay |
| Возврат |  |
| Организация и стоимость подключения | По согласованию с курирующим менеджером Flashpay |
Основные операции
| Интерфейсы | |||
|---|---|---|---|
| Payment Page | Gate | Dashboard | |
| Выплата | |
 |
|
Уточнить минимальную и максимальную сумму платежа, доступную в вашем проекте, вы можете в Dashboard. Для этого в Dashboard перейдите в раздел Проекты и выберите вкладку Платежные методы.
Далее подробно рассказывается, что вам нужно делать для проведения платежа, а также о возможностях анализа уже проведенных платежей.
Выплата через Gate
Общая информация
Чтобы выполнить выплату через Gate с использованием метода Выплаты на карты в Турции:
- Опционально: запросите актуальный курс валюты и ознакомьте пользователя с ориентировочной суммой выплаты.
- Отправьте запрос с нужными параметрами и подписью на рабочий URL-адрес платежной платформы Flashpay.
- Примите от платежной платформы Flashpay оповещение (callback) с результатом выплаты.
Полная схема выплаты с использованием метода Выплаты на карты в Турции выглядит следующим образом.
- Пользователь инициирует выплату с использованием метода Выплаты на карты в Турции в вашей системе.
- Ваша система передает запрос на получение актуального курса валюты в платежную платформу Flashpay.
- Платежная платформа Flashpay отправляет вам синхронный ответ с информацией об актуальном курсе валюты.
- Ваша система отображает пользователю ориентировочную сумму выплаты в выбранной им валюте.
- Пользователь подтверждает выплату.
- Ваша система передает запрос на выплату в платежную платформу Flashpay.
- Платежная платформа отправляет вам ответ с информацией о получении запроса и о результате проверки его корректности. (Подробнее о формате ответа см. Формат ответа.)
- Платежная платформа обрабатывает запрос и отправляет его в сервис провайдера.
- Сервис провайдера оповещает платежную платформу о результате выплаты.
- Платежная платформа отправляет вам оповещение (callback) с результатом выплаты.
- Ваша система направляет пользователю информацию о результате выплаты.
Запрос
Далее представлена информация, необходимая для создания и отправки запроса на выплату с использованием метода Выплаты на карты в Турции.
| HTTP-метод запроса | POST |
| Формат тела запроса | JSON |
| Конечная точка | /v2/payment/card/payout |
|
|||
|---|---|---|---|
| Объект | Параметр | Описание | |
general | project_id | Идентификатор проекта, полученный от Flashpay при интеграции. Пример: | |
payment_id | Идентификатор платежа, уникальный в рамках проекта. Пример: | ||
signature | Подпись запроса, составленная после определения всех параметров запроса. Подробнее о составлении подписи см. Использование подписи к данным. | ||
customer | id | Идентификатор пользователя, уникальный в рамках проекта. Пример: | |
ip_address | IP-адрес устройства пользователя. Пример: | ||
first_name | Имя пользователя. Пример: | ||
last_name | Фамилия пользователя. Пример: | ||
sender | first_name | Имя отправителя. Пример: | |
last_name | Фамилия отправителя. Пример: | ||
payment | currency | Код валюты платежа в формате ISO-4217 alpha-3. Пример: | |
amount | Сумма платежа в дробных единицах валюты без десятичного разделителя (точки или запятой) и пробелов за исключением случаев, когда у валюты нет дробной части. Если у валюты нет дробных единиц (то есть количество разрядов дробных единиц равно нулю), то в этом параметре нужно указывать сумму в основных единицах валюты. Подробнее о разрядах дробных единиц у валют см. Использование дробных единиц валюты и Коды валют. Пример: 100,00 RUB передается как | ||
sender_amount | Сумма, списываемая с счета отправителя, в дробных единицах валюты. Пример: | ||
sender_currency | Код валюты для списываемой суммы в формате ISO-4217 alpha-3. Пример: | ||
card | pan | Номер банковской карты пользователя. Пример: | |
| При необходимости добавьте в запрос необязательные параметры, указанные в спецификации Gate: API Reference. | |||
Вот пример тела запроса на выплату с использованием метода Выплаты на карты в Турции:
{
"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"
},
"sender": {
"first_name": "Jane",
"last_name": "Doe"
},
"payment": {
"currency": "RUB",
"amount": 10000,
"sender_amount": 10000,
"sender_currency": "RUB"
},
"card": {
"pan": "1234567890123456"
}
}
Оповещение (callback)
В методе Выплаты на карты в Турции результат выплаты платежная платформа возвращает в оповещении. Подробнее о структуре оповещений см. Оповещения.
Вот пример тела оповещения с информацией об успешно выполненной выплате:
{
"project_id": 1234,
"payment": {
"id": "payment_47",
"type": "payout",
"status": "success",
"date": "2024-12-07T19:08:45+0000",
"method": "card",
"sum": {
"amount": 10000,
"currency": "RUB"
},
"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": "RUB"
},
"sum_converted": {
"amount": 10000,
"currency": "RUB"
},
"code": "0",
"message": "Success",
"provider": {
"id": 12345,
"payment_id": "123abc123-123",
"auth_code": ""
}
},
"account": {
"number": "1234567890123456",
"type": "visa",
"card_holder": ""
},
"signature": "U7HQO7ToISZhMPKdM4XrUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}
Вот пример тела оповещения с информацией об отклоненной выплате.
{
"project_id": 1234,
"payment": {
"id": "payment_47",
"type": "payout",
"status": "decline",
"date": "2024-12-07T19:08:45+0000",
"method": "card",
"sum": {
"amount": 10000,
"currency": "RUB"
},
"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": "RUB"
},
"sum_converted": {
"amount": 10000,
"currency": "RUB"
},
"code": "20000",
"message": "General decline",
"provider": {
"id": 12345,
"payment_id": "123abc123-123",
"auth_code": ""
}
},
"account": {
"number": "1234567890123456",
"type": "visa",
"card_holder": ""
},
"signature": "U7HQO7ToISZhMPKdM4XrUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}
Выплаты через Dashboard
При использовании интерфейса Dashboard можно проводить одиночные и массовые выплаты методом Выплаты на карты в Турции с единичной и пакетной отправкой запросов, называемые соответственно одиночными и массовыми.
- Для проведения одиночной выплаты необходимо открыть форму выплаты, задать все необходимые параметры (включая метод), отправить запрос и убедиться в проведении выплаты.
-
Для проведения массовой выплаты необходимо подготовить и загрузить файл с информацией обо всех целевых выплатах, отправить пакет запросов и убедиться в проведении выплат.
При этом должен использоваться файл формата CSV, структура которого соответствует требованиям, представленным в разделе Сведения о массовых платежах, а параметры выплат — должны соответствовать требованиям, представленным в разделе Выплаты через Gate этой статьи (за исключением пункта о подписи).
Более подробная информация о проведении выплат через Dashboard представлена в отдельной статье.