«Выплаты на банковские счета в ЕЗПЕ (SEPA)»

Введение

«Выплаты на банковские счета в ЕЗПЕ (SEPA)» — метод, позволяющий проводить платежи в евро с использованием банковских счетов в странах единой зоны платежей в евро (ЕЗПЕ; SEPA). Для этого метода в платёжной платформе ecommpay поддерживаются выплаты. Вместе с тем, для проведения оплат при работе с этим методом могут использоваться комплементарные методы группы Open Banking.

В этой статье представлена информация о работе с методом «Выплаты на банковские счета в ЕЗПЕ (SEPA)»: обзорный раздел с общими сведениями и последующие разделы с информацией о действиях, необходимых со стороны мерчанта для решения разных задач.

Характеристика

Схема работы

В проведении отдельного платежа с использованием метода «Выплаты на банковские счета в ЕЗПЕ (SEPA)» задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа ecommpay, а также технические средства сервиса провайдера.

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

Для проведения платежей и выполнения операций с использованием метода «Выплаты на банковские счета в ЕЗПЕ (SEPA)» могут применяться различные интерфейсы платёжной платформы. Так, выплаты могут проводиться через Gate и Dashboard. При этом, независимо от используемых интерфейсов, для этого метода характерны следующие свойства и ограничения.

При работе с методом «Выплаты на банковские счета в ЕЗПЕ (SEPA)», независимо от используемых интерфейсов, актуальны следующие свойства и ограничения.

Сценарии использования

Проведение выплат с использованием метода «Выплаты на банковские счета в ЕЗПЕ (SEPA)» осуществляется с уведомлением пользователей через веб-сервис мерчанта.

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

Для проведения выплаты через Gate с использованием метода «Выплаты на банковские счета в ЕЗПЕ (SEPA)» со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате. Полная схема проведения выплаты выглядит следующим образом.

Информация о форматах запросов и оповещений, используемых для проведения выплат методом «Выплаты на банковские счета в ЕЗПЕ (SEPA)» через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье Организация взаимодействия.

Формат запросов

При работе с запросами на выплаты с применением метода «Выплаты на банковские счета в ЕЗПЕ (SEPA)» необходимо учитывать следующее:

1. Для инициирования каждой выплаты должен использоваться отдельный POST-запрос к конечной точке /v2/payment/bank-transfer/world/payout. Эта точка относится к группе /v2/payment/bank-transfer/{payment_method}/payout.
2. В каждом запросе должны использоваться следующие объекты и параметры:
   • general — объект, содержащий основные идентификационные сведения запроса:
     • project_id — идентификатор проекта, полученный от ecommpay при интеграции;,
     • payment_id — идентификатор платежа, уникальный в рамках проекта;,
     • signature — подпись запроса, составленная после указания всех целевых параметров (подробнее — в разделе Работа с подписью к данным); (подробнее),
   • payment — объект, содержащий сведения о платеже:
     • amount — сумма выплаты в дробных единицах валюты;,
     • currency — код валюты платежа в формате ISO-4217 alpha-3;,
     • description — описание платежа;,
   • customer — объект, содержащий сведения о получателе:
     • id — идентификатор получателя, уникальный в рамках проекта;,
     • ip_address — IP-адрес получателя, актуальный для инициируемой выплаты;,
     • first_name — полное имя или название получателя;,
   • account — объект, содержащий сведения о счёте получателя:
     • number — номер счёта получателя (IBAN).
3. Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.

Таким образом, корректный запрос на выплату с применением метода «Выплаты на банковские счета в ЕЗПЕ (SEPA)» должен содержать идентификатор проекта, базовые сведения о платеже (его идентификатор, сумму и код валюты), идентификатор, IP-адрес имя или название получателя, описание платежа, номер счёта и подпись.

 {
  "general": {
    "project_id": 3027,
    "payment_id": "payout1",
    "signature": "M1vT4q9XAaq7/Jkn+aJmGA4jH6bgBOp8DTf8d/XdoV+vd7Q=="
  },
   "customer": {
     "id": "customer1",
     "ip_address": "192.0.2.0",
     "first_name": "John Doe"
  },
   "account": {
     "number": "FI1410093000123458"
  },
   "payment": {
     "amount": 10000,
     "currency": "EUR",
     "description": "test payout"
  }
}

 {
  "general": {
    "project_id": 3027,
    "payment_id": "payout1",
    "signature": "M1vT4q9XAaq7/Jkn+aJmGA4jH6bgBOp8DTf8d/XdoV+vd7Q=="
  },
   "customer": {
     "id": "customer1",
     "ip_address": "192.0.2.0",
     "first_name": "John Doe"
  },
   "account": {
     "number": "FI1410093000123458"
  },
   "payment": {
     "amount": 10000,
     "currency": "EUR",
     "description": "test payout"
  }
}

Формат оповещений

Для оповещений о результатах выплат с применением метода «Выплаты на банковские счета в ЕЗПЕ (SEPA)» используется типовой формат, описание которого представлено в разделе Работа с оповещениями.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 4990 была проведена выплата в размере 211,00 EUR.

{
        "project_id": 4990,
        "payment": {
            "id": "53923_33600681",
            "type": "payout",
            "status": "success",
            "date": "2021-02-22T13:39:45+0000",
            "method": "world",
            "sum": {
                "amount": 21100,
                "currency": "EUR"
            },
            "description": "test description"
        },
        "account": {
            "number": "123456"
        },
        "customer": {
            "id": "customer1"
        },
        "operation": {
            "id": 6325000000075,
            "type": "payout",
            "status": "success",
            "date": "2021-02-22T13:39:45+0000",
            "created_date": "2021-02-22T13:39:23+0000",
            "request_id": "9a9c4985044f5927dae77daac4b8e488b2-00006326",
            "sum_initial": {
                "amount": 21100,
                "currency": "EUR"
            },
            "sum_converted": {
                "amount": 21100,
                "currency": "EUR"
            },
            "code": "0",
            "message": "Success",
            "provider": {
                "id": 2945,
                "payment_id": "j29vEXRSAd",
                "auth_code": ""
            }
        },
        "signature": "7bxR3Ssoemv3o5mpabmg529+/NkpdYPLMN1sBw=="
    }

В следующем примере оповещение свидетельствует об отклонённой выплате.

{
        "project_id": 4990,
        "payment": {
            "id": "21571027",
            "type": "payout",
            "status": "decline",
            "date": "2021-02-22T13:30:44+0000",
            "method": "world",
            "sum": {
                "amount": 30400,
                "currency": "EUR"
            },
            "description": "test description"
        },
        "account": {
            "number": "1234567"
        },
        "customer": {
            "id": "customer2"
        },
        "operation": {
            "id": 9698000000069,
            "type": "payout",
            "status": "decline",
            "date": "2021-02-22T13:30:44+0000",
            "created_date": "2021-02-22T13:30:23+0000",
            "request_id": "3c6027f04491e63df2d67f755e3b45f64-00009699",
            "sum_initial": {
                "amount": 30400,
                "currency": "EUR"
            },
            "sum_converted": {
                "amount": 30400,
                "currency": "EUR"
            },
            "code": "20000",
            "message": "General decline",
            "provider": {
                "id": 2945,
                "payment_id": "j29KmZH29J",
                "auth_code": ""
            }
        },
        "signature": "KTCGrXiG/cQzANBw2s730kE6toB+EDa619tqB9qQeg=="
    }

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

Для организации работы с выплатами через Gate также могут быть полезны следующие материалы:

• Организация взаимодействия — о том, как взаимодействовать с платёжной платформой через Gate.
• Работа с подписью к данным — о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
• Проведение платежей — о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
• Выплаты — о том, как проводить выплаты через Gate.
• Работа с информацией об операциях — о служебных кодах, используемых в платёжной платформе для фиксации информации о выполнении операций.