Выплаты на банковские счета в Турции - Выплата

Пользователь инициирует платеж, после чего ожидает зачисление средств на свой счет. Непосредственное участие пользователя в процессе проведения выплаты не требуется.


Регионы использования	Турция
Валюты выплаты	TRY
Суммы платежей	Информацию уточняйте у курирующего менеджера Flashpay. Также вы можете уточнить в Dashboard минимальную и максимальную сумму платежа, доступную в вашем проекте.
Время проведения платежа	Информацию уточняйте у курирующего менеджера Flashpay.
Конвертация валют	На стороне Flashpay
Возврат
Организация и стоимость подключения	По согласованию с курирующим менеджером Flashpay

Основные операции


	Интерфейсы
	Payment Page	Gate	Dashboard
Выплата

Уточнить минимальную и максимальную сумму платежа, доступную в вашем проекте, вы можете в Dashboard. Для этого в Dashboard перейдите в раздел Проекты и выберите вкладку Платежные методы.

Далее подробно рассказывается, что вам нужно делать для проведения платежа, а также о возможностях анализа уже проведенных платежей.

Выплата через Gate

Общая информация

Чтобы выполнить выплату через Gate с использованием метода Выплаты на банковские счета в Турции:

Опционально: запросите актуальный курс валюты и ознакомьте пользователя с ориентировочной суммой выплаты.
Отправьте запрос с нужными параметрами и подписью на рабочий URL-адрес платежной платформы Flashpay.
Примите от платежной платформы Flashpay оповещение (callback) с результатом выплаты.

Полная схема выплаты с использованием метода Выплаты на банковские счета в Турции выглядит следующим образом.

Рис. 1. Здесь описаны шаги выплаты через Gate

Прим.: Шаги 2-5 не являются обязательными, их можно пропустить.

Пользователь инициирует выплату с использованием метода Выплаты на банковские счета в Турции в вашей системе.
Ваша система передает запрос на получение актуального курса валюты в платежную платформу Flashpay.
Платежная платформа Flashpay отправляет вам синхронный ответ с информацией об актуальном курсе валюты.
Ваша система отображает пользователю ориентировочную сумму выплаты в выбранной им валюте.
Пользователь подтверждает выплату.
Ваша система передает запрос на выплату в платежную платформу Flashpay.
Платежная платформа отправляет вам ответ с информацией о получении запроса и о результате проверки его корректности. (Подробнее о формате ответа см. Формат ответа.)
Платежная платформа обрабатывает запрос и отправляет его в сервис провайдера.
Сервис провайдера оповещает платежную платформу о результате выплаты.
Платежная платформа отправляет вам оповещение (callback) с результатом выплаты.
Ваша система направляет пользователю информацию о результате выплаты.

Запрос

Далее представлена информация, необходимая для создания и отправки запроса на выплату с использованием метода Выплаты на банковские счета в Турции.


HTTP-метод запроса	POST
Формат тела запроса	JSON
Конечная точка	`/v2/payment/bank-transfer/turkey/payout`
Полная спецификация конечной точки	/v2/payment/bank-transfer/{payment_method}/payout

strictly required — параметр обязательно должен присутствовать в начальном запросе.

Объект Параметр Описание

general
object
strictly required

project_id
integer
strictly required

Идентификатор проекта, полученный от Flashpay при интеграции.

Пример: 1234

payment_id
string
strictly required

Идентификатор платежа, уникальный в рамках проекта.

Пример: payment_47

signature
string
strictly required

Подпись запроса, составленная после определения всех параметров запроса. Подробнее о составлении подписи см. Использование подписи к данным.

customer
object
strictly required

id
string
strictly required

Идентификатор пользователя, уникальный в рамках проекта.

Пример: customer_123

ip_address
string
strictly required

IP-адрес устройства пользователя.

Пример: 198.51.100.47

first_name
string
strictly required

Имя пользователя.

Пример: John

last_name
string
strictly required

Фамилия пользователя.

Пример: Doe

account
object
strictly required

number
string
strictly required

Номер счета пользователя.

Пример: TR24...388

sender
object
strictly required

first_name
string
strictly required

Имя отправителя.

Пример: Jane

last_name
string
strictly required

Фамилия отправителя.

Пример: Doe

payment
object
strictly required

currency
string
strictly required

Код валюты платежа в формате ISO-4217 alpha-3.

Пример: RUB

amount
integer
strictly required

Сумма платежа в дробных единицах валюты без десятичного разделителя (точки или запятой) и пробелов за исключением случаев, когда у валюты нет дробной части.

Если у валюты нет дробных единиц (то есть количество разрядов дробных единиц равно нулю), то в этом параметре нужно указывать сумму в основных единицах валюты. Подробнее о разрядах дробных единиц у валют см. Использование дробных единиц валюты и Коды валют.

Пример: 100,00 RUB передается как 10000

sender_amount
integer
strictly required

Сумма, списываемая с счета отправителя, в дробных единицах валюты.

Пример: 10000

sender_currency
string
strictly required

Код валюты для списываемой суммы в формате ISO-4217 alpha-3.

Пример: RUB

При необходимости добавьте в запрос необязательные параметры, указанные в спецификации Gate: API Reference.

Вот пример тела запроса на выплату с использованием метода Выплаты на банковские счета в Турции:

Рис. 2. Пример тела запроса на выплату

{
    "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"
    },
    "account": {
        "number": "TR24...388"
    },
    "sender": {
        "first_name": "Jane",
        "last_name": "Doe"
    },
    "payment": {
        "currency": "RUB",
        "amount": 10000,
        "sender_amount": 10000,
        "sender_currency": "RUB"
    }
}

Оповещение (callback)

В методе Выплаты на банковские счета в Турции результат выплаты платежная платформа возвращает в оповещении. Подробнее о структуре оповещений см. Оповещения.

Вот пример тела оповещения с информацией об успешно выполненной выплате:

Рис. 3. Пример тела оповещения об успешной выплате

{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "payout",
        "status": "success",
        "date": "2024-12-07T19:08:45+0000",
        "method": "Bank transfer Turkey",
        "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": "TR24...388"
    },
    "signature": "U7HQO7ToISZhMPKdM4XrUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}

Вот пример тела оповещения с информацией об отклоненной выплате.

Рис. 4. Пример тела оповещения об отклоненной выплате

{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "payout",
        "status": "decline",
        "date": "2024-12-07T19:08:45+0000",
        "method": "Bank transfer Turkey",
        "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": "TR24...388"
    },
    "signature": "U7HQO7ToISZhMPKdM4XrUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}

Дополнительные материалы

Выплаты через Dashboard

При использовании интерфейса Dashboard можно проводить одиночные и массовые выплаты методом Выплаты на банковские счета в Турции с единичной и пакетной отправкой запросов, называемые соответственно одиночными и массовыми.

Для проведения одиночной выплаты необходимо открыть форму выплаты, задать все необходимые параметры (включая метод), отправить запрос и убедиться в проведении выплаты.
Для проведения массовой выплаты необходимо подготовить и загрузить файл с информацией обо всех целевых выплатах, отправить пакет запросов и убедиться в проведении выплат.

При этом должен использоваться файл формата CSV, структура которого соответствует требованиям, представленным в разделе Сведения о массовых платежах, а параметры выплат — должны соответствовать требованиям, представленным в разделе Выплаты через Gate этой статьи (за исключением пункта о подписи).

Более подробная информация о проведении выплат через Dashboard представлена в отдельной статье.