Переводы

Перевод — это тип платежа, в рамках которого на основании одного исходного запроса для перевода денежных средств от отправителя к получателю последовательно выполняются две операции: списание средств отправителя и зачисление средств получателю. При этом в разных случаях отправителем и получателем могут выступать как одни и те же, так и разные пользователи, для списания и зачисления средств могут использоваться различные платёжные инструменты, а мерчант каждый раз выступает в роли посредника, предоставляющего сервис для таких переводов.

Чтобы провести перевод через Gate, необходимо:

1. Отправить запрос к конечной точке/v2/payment/money_transfer .
2. При необходимости выполнить вспомогательные процедуры (такие как Аутентификация 3‑D Secure).
3. Принять от платёжной платформы оповещение о результате перевода.

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

При формировании запросов на перевод в общем случае необходимо руководствоваться спецификацией конечной точки /v2/payment/money_transfer, а в случае с переводом с одной платёжной карты на другую (что можно считать типовым вариантом перевода) необходимо учитывать следующее:

1. POST-запрос должен отправляться к конечной точке - /v2/payment/money_transfer
2. В запросе должны использоваться следующие объекты и параметры:
   • general — объект, содержащий основные идентификационные сведения запроса:
     • project_id — идентификатор проекта, полученный от Flashpay при интеграции;
     • payment_id — идентификатор платежа, уникальный в рамках проекта мерчанта;
     • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Работа с подписью к данным);
   • customer — объект, содержащий сведения об отправителе:
     • id — идентификатор пользователя (отправителя) в рамках проекта мерчанта;
     • ip_address — актуальный IP-адрес;
     • country — код страны адреса пользователя в формате ISO 3166-1 alpha-2;
     • city — название города проживания пользователя (или иного населенного пункта);
     • first_name — имя пользователя;
     • last_name — фамилия пользователя;
     • zip — почтовый индекс пользователя;
     • address — название улицы и номер дома (с обозначением корпуса или строения, где это актуально) в адресе проживания пользователя;
     • phone — номер телефона отправителя перевода, который должен передаваться в случаях, если зачисление средств выполняется на карту платёжной системы Visa, выпущенную в Бразилии или Катаре;
   • recipient_customer — объект, содержащий сведения о получателе:
     • first_name — имя получателя;
     • last_name — фамилия получателя;
     • phone — номер телефона получателя;
     • email — адрес электронной почты получателя;
   • payment — объект, содержащий сведения о переводе:
     • sender_payment_method — код платёжного метода для операции списания;
     • recipient_payment_method — код платёжного метода для операции зачисления;
     • sender_amount — сумма, списываемая с отправителя, в дробных единицах валюты;
     • sender_currency — код валюты для списываемой суммы в формате ISO-4217 alpha-3;
     • recipient_amount — сумма, зачисляемая получателю, в дробных единицах валюты;
     • recipient_currency — код валюты для зачисляемой суммы в формате ISO-4217 alpha-3.
3. В запросе должны содержаться сведения о платёжном инструменте отправителя. При передаче реквизитов в явном виде — следующие данные в объекте sender:
   • pan — номер платёжной карты (без пробелов и иных разделителей);
   • year — номер года, в котором заканчивается срок действия карты (в четырёхзначном формате YYYY по григорианскому календарю)
   • month — номер месяца, в котором заканчивается срок действия карты (в виде числа, без ведущего нуля);
   • card_holder — имя и фамилия держателя карты (в соответствии с указанными на карте);
   • cvv — код проверки подлинности карты.
4. В запросе должны содержаться сведения о платёжном инструменте получателя. При передаче реквизитов в явном виде — следующие данные в объекте recipient:
   • pan — номер платёжной карты (без пробелов и иных разделителей);
   • card_holder — имя и фамилия держателя карты (в соответствии с указанными на карте).
5. Дополнительно могут использоваться любые другие параметры, указанные в спецификации.

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

{
  "general":{
    "project_id": 440694,
    "payment_id": "ORDER_9777113840",
    "signature": "QsbTriwuNYLzqDYMm/roHPirhlvRpsuCm4yt0yiWNhWviXsmTvE8TKjsEdzQXrakGLIzA1G/eHzOno5HQLEusA=="
    },
  "recipient":{
    "number": "4242424242424242"
    },
  "sender":{
    "pan":"4314220000000056",
    "year":2024,
    "month":10,
    "card_holder":"Gio Boccaccio",
    "cvv":"334"
    },
  "payment":{
    "sender_amount": 10000,
    "sender_currency": "RUB",
    "sender_payment_method":"card",
    "recipient_amount": 10000,
    "recipient_currency": "TRY",
    "recipient_payment_method":"bank-transfer/turkey"
    },
  "customer":{       
    "id": "Vally",
    "first_name": "Orhan",
    "last_name": "Pamuk",
    "ip_address": "1.0.4.0"
    },
  "recipient_customer":{       
    "first_name": "Fatma",
    "last_name": "Aliye",
    "phone": "3572437356",
    "email": "test@example.com"
    }
}