Переводы с карты на карту

В этом разделе представлена информация о проведении переводов между платёжными картами, которая дополняет сведения из модели проведения платежей (Перевод с карты на карту).

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

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

В платёжной платформе возможны следующие варианты проведения переводов с карты на карту:

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

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

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

При проведении сокращённого варианта перевода реквизиты платёжной карты можно указать в явном виде, в виде токена, ассоциированного с реквизитами карты (подробнее — в разделе Использование токенов). В случае списания средств реквизиты платёжной карты отправителя также можно указать в виде идентификатора реквизитов.

Ограничения и особенности

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

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

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

  • Перед отправкой запроса на отмену списания следует убедиться, что зачисление средств пользователю не было выполнено. Это необходимо, чтобы предотвратить отмену списания средств, уже зачисленных пользователю. При проведении сокращённого варианта перевода контроль за зачислением средств возлагается на мерчанта.
  • Запрос на отмену списания следует использовать только в тех ситуациях, когда зачисление средств не было выполнено и мерчанту необходимо вернуть пользователю списанные средства, предназначенные для этого зачисления. Рекомендуемый промежуток времени для отправки такого запроса — 30 минут с момента выполнения списания. Если по каким-либо причинам выполнить отмену списания необходимо после этого промежутка времени, следует учитывать требования международных платёжных систем для этого типа операции.

    Прим.:

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

    В случае использования карт платёжной системы Mastercard запрос на отмену списания можно отправлять до закрытия операционного дня. После закрытия операционного дня возможность отмены списания следует уточнять у сотрудников технической поддержки.

Схемы проведения

Базовый вариант

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

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

Схема проведения перевода с карты на карту в базовом случае — без выполнения вспомогательной процедуры — представлена далее.

Рис.: Проведение перевода в базовом случае

  1. Пользователь (отправитель перевода) на стороне веб-сервиса инициирует перевод.
  2. От веб-сервиса на заданный URL ECommPay передаётся запрос на проведение платежа.
  3. Запрос на проведение платежа поступает в платёжную платформу.
  4. В платёжной платформе выполняется приём запроса с проверкой его корректности.
  5. От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности.
  6. В платёжной платформе выполняется обработка запроса.
  7. От платёжной платформы к платёжной системе и далее к эмитенту пользователя (отправителя) направляется запрос на списание средств.
  8. На стороне эмитента отправителя выполняется обработка запроса на списание средств.
  9. От эмитента в платёжную систему и далее в платёжную платформу направляется уведомление о результате.
  10. В платёжной платформе выполняется обработка полученного результата.
  11. От платёжной платформы к платёжной системе и далее к эмитенту получателя перевода направляется запрос на зачисление средств.
  12. На стороне эмитента получателя выполняется обработка запроса на зачисление средств.
  13. От эмитента в платёжную систему и далее в платёжную платформу направляется уведомление о результате.
  14. От платёжной платформы к веб-сервису направляется оповещение о результате платежа.
  15. От веб-сервиса пользователю направляется результат проведения перевода.

В случае, если запрос на зачисление средств получателю отклонён, платёжная платформа автоматически инициирует отмену списания средств отправителя — операцию reversal. Далее представлена схема выполнения отмены списания средств в рамках проведения перевода с карты на карту.

Рис.: Проведение перевода в случае отказа на зачисление

  1. В платёжной платформе выполняется обработка полученного результата.
  2. От платёжной платформы к платёжной системе и далее к эмитенту получателя направляется запрос на зачисление средств.
  3. На стороне эмитента получателя выполняется обработка запроса.
  4. От эмитента в платёжную систему и далее в платёжную платформу направляется уведомление о результате.
  5. В платёжной платформе выполняется обработка результата и инициируется отмена списания средств.
  6. От платёжной платформы к платёжной системе и далее к эмитенту отправителя направляется запрос на отмену списания средств.
  7. На стороне эмитента отправителя выполняется обработка запроса.
  8. От эмитента в платёжную систему и далее в платёжную платформу направляется уведомление о результате.
  9. От платёжной платформы к веб-сервису направляется оповещение о результате платежа.
  10. От веб-сервиса пользователю направляется уведомление об отказе в проведении перевода.

Сокращённый вариант

Чтобы инициировать списание средств в рамках сокращённого варианта проведения перевода через Gate, со стороны веб-сервиса необходимо:

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

Чтобы инициировать отмену списания в рамках сокращённого варианта проведения перевода через Gate, со стороны веб-сервиса необходимо отправить запрос c требуемыми параметрами и подписью к конечной точке v2/payment/card/money_transfer/in/refund, после чего принять оповещение о результате отмены списания.

Чтобы инициировать зачисление средств в рамках сокращённого варианта проведения перевода через Gate, со стороны веб-сервиса необходимо:

  1. Отправить запрос к конечной точке /v2/payment/card/money_transfer/out.
  2. Принять от платёжной платформы оповещение о результате зачисления средств.

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

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

В этом разделе представлен формат запросов как для базового, так и для сокращённого варианта проведения переводов (списание и зачисление), в том числе запроса на отмену списания средств в рамках проведения сокращённого варианта перевода.

Базовый вариант

При формировании запросов в случае базового проведения перевода необходимо учитывать следующее:

  1. POST-запрос должен отправляться к одной из следующих конечных точек:
  2. В запросе должны использоваться следующие объекты и параметры:
    • general — объект, содержащий основные идентификационные сведения запроса:
      • project_id — идентификатор проекта, полученный от ECommPay при интеграции;
      • payment_id — идентификатор платежа, уникальный в рамках проекта мерчанта;
      • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Работа с подписью к данным);
    • customer — объект, содержащий сведения об отправителе:
      • id — идентификатор пользователя (отправителя) в рамках проекта мерчанта;
      • ip_address — используемый IP-адрес;
      • country — страна адреса пользователя в формате ISO 3166-1 alpha-2;
      • city — город проживания (или иной населенный пункт);
      • first_name — имя пользователя;
      • last_name — фамилия пользователя;
      • zip — почтовый индекс пользователя;
      • address — адрес проживания;
    • payment — объект, содержащий сведения о переводе:
      • sender_amount — сумма, списываемая с платёжной карты отправителя, в минорных единицах валюты;
      • sender_currency — код валюты для списываемой суммы в формате ISO-4217 alpha-3;
      • recipient_amount — сумма, зачисляемая на платёжную карту получателя, в минорных единицах валюты;
      • recipient_currency — код валюты для зачисляемой суммы в формате ISO-4217 alpha-3.
  3. В запросе должны содержаться сведения о платёжной карте отправителя:
    • При передаче реквизитов в явном виде — следующие данные в объекте sender:
      • pan — номер карты;
      • year — год окончания срока действия;
      • month — месяц окончания срока действия;
      • card_holder — имя и фамилия отправителя (в соответствии с указанными на карте);
      • cvv — код проверки подлинности карты;
    • При передаче идентификатора — следующие данные в объекте sender:
      • saved_account_id — идентификатор, ассоциированный с реквизитами карты в платёжной платформе;
      • cvv — код проверки подлинности карты.
  4. В запросе должны содержаться сведения о платёжной карте получателя:
    • При передаче реквизитов в явном виде — следующие данные в объекте recipient:
      • pan — номер платёжной карты получателя;
      • card_holder — имя и фамилия получателя (в соответствии с указанными на карте);
    • При передаче идентификатора — объект recipient с параметром saved_account_id.
  5. Если требуется проверка в рамках Address Verification Service (обязательная для платежей, совершаемых на территории Великобритании, и возможная для США, Австралии, Канады и Новой Зеландии), в запрос необходимо включить объект AvsInfo с данными адреса, который зафиксирован эмитентом как актуальный для отправителя перевода:
    • avs_post_code — почтовый индекс;
    • avs_street_address — улица и номер дома.
  6. Дополнительно могут использоваться любые другие параметры, указанные в спецификации.

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

Рис.: Пример тела запроса на перевод

{
  "general":{
    "project_id":91348,
    "payment_id":"135113521354",
    "signature":"iehD3ZeW3CM7aGfmdgfjdgneHbCmronMpXom1b/ot1HvOGMV+CT8LA=="
  },
  "customer":{
    "id":"16061313",
    "ip_address":"93.47.230.225",
    "first_name":"Gio",
    "last_name":"Boccaccio",
    "country":"IT",
    "city":"Florence",
    "zip":"50052",
    "address":"Via Certaldo 18"
  },
  "payment":{
    "sender_amount":100,
    "sender_currency":"EUR",
    "recipient_amount":100,
    "recipient_currency":"EUR"
  },
//при передаче реквизитов карты отправителя в явном виде:
  "sender":{
    "pan":"4276381374757433",
    "year":2024,
    "month":10,
    "card_holder":"Gio Boccaccio",
    "cvv":"334"
  },
//при передаче идентификатора ранее сохранённой платёжной карты отправителя:
  "sender":{
    "saved_account_id": 21121375,
    "cvv": "334"
  },
//при передаче реквизитов карты получателя в явном виде:
  "recipient":{
    "pan":"5484381034771304",
    "card_holder":"Fran Petrarca"
  }
//при передаче идентификатора ранее сохранённой платёжной карты получателя:
  "recipient":{
    "saved_account_id": 19071374
  }
}

Сокращённый вариант

При формировании запросов только на списание средств необходимо учитывать следующее:

  1. POST-запрос должен отправляться к одной из следующих конечных точек:
  2. В запросе должны использоваться следующие объекты и параметры:
    • general — объект, содержащий основные идентификационные сведения запроса:
      • project_id — идентификатор проекта, полученный от ECommPay при интеграции;
      • payment_id — идентификатор платежа, уникальный в рамках проекта мерчанта;
      • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Работа с подписью к данным);
    • payment — объект, содержащий сведения о переводе:
      • sender_amount — сумма перевода, списываемого с платёжной карты отправителя, в минорных единицах валюты;
      • sender_currency — код валюты для списываемой суммы в формате ISO-4217 alpha-3;
    • customer — объект, содержащий сведения об отправителе:
      • id — идентификатор пользователя в рамках проекта мерчанта;
      • ip_address — используемый IP-адрес.
  3. В запросе должны содержаться сведения о платёжной карте отправителя в объекте sender:
    • При передаче реквизитов в явном виде:
      • pan — номер карты;
      • year — год окончания срока действия;
      • month — месяц окончания срока действия;
      • card_holder — имя и фамилия держателя карты (в соответствии с указанными на карте);
      • cvv — код проверки подлинности карты.
    • При передаче токена:
      • token — токен карты;
      • cvv — код проверки подлинности карты;
      • card_holder — имя и фамилия держателя карты (в соответствии с указанными на карте), если этот параметр не был передан при формировании используемого токена (подробнее о формировании токенов).
    • При передаче идентификатора:
      • saved_account_id — идентификатор, ассоциированный с реквизитами карты в платёжной платформе;
      • cvv — код проверки подлинности карты.
  4. В запросе должны содержаться сведения о получателе перевода в объекте recipient:
    • При передаче реквизитов платёжной карты получателя:
      • pan — номер карты;
      • card_holder — имя и фамилия получателя (в соответствии с указанными на карте);
    • При передаче сведений о счёте получателя:
      • wallet_id — номер кошелька, который может использоваться в сокращённом варианте перевода;
      • wallet_owner — имя и фамилия получателя;
      • country — код страны получателя в формате ISO 3166-1 alpha-2.
  5. Если требуется проверка в рамках Address Verification Service (обязательная для платежей, совершаемых на территории Великобритании, и возможная для США, Австралии, Канады и Новой Зеландии), в запрос необходимо включить объект AvsInfo с данными адреса, который зафиксирован эмитентом как актуальный для отправителя перевода:
    • avs_post_code — почтовый индекс;
    • avs_street_address — улица и номер дома.
  6. Дополнительно могут использоваться любые другие параметры, указанные в спецификации.

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

Рис.: Пример тела запроса на списание в рамках перевода

{
  "general":{
    "project_id":91348,
    "payment_id":"135113521354",
    "signature":"iehD3ZeW3CM7aGfmdgfjdgneHbCmronMpXom1b/ot1HvOGMV+CT8LA=="
  },
  "customer":{
    "id":"16061313",
    "ip_address":"93.47.230.225"
  },
  "payment":{
    "transfer_type":"in",
    "sender_amount":100,
    "sender_currency":"EUR"
  },
//при передаче реквизитов карты отправителя в явном виде:
  "sender":{
    "pan":"4276381374757433",
    "year":2024,
    "month":10,
    "card_holder":"Gio Boccaccio",
    "cvv":"334"
  },
//при передаче токена карты отправителя:
  "sender":{
    "token":"f365bb1729f9b72fd9c09703a751c979f3becc67",
    "card_holder":"Gio Boccaccio",
    "cvv":"334"
  },
//при передаче идентификатора ранее сохранённой платёжной карты:
  "sender":{
    "saved_account_id": 21121375,
    "cvv": "334"
  },
//при передаче реквизитов карты получателя:
"recipient":{
    "pan":"5484381034771304",
    "card_holder":"Fran Petrarca"
  }
//при передаче сведений о счёте получателя:
"recipient":{
    "wallet_id":"WID20071304"
    "wallet_owner":"Fran Petrarca",
    "country":"IT"
  }
}

При формировании запросов только на зачисление средств необходимо учитывать следующее:

  1. POST-запрос должен отправляться к конечной точке /v2/payment/card/money_transfer/out.
  2. В запросе должны использоваться следующие объекты и параметры:
    • general — объект, содержащий основные идентификационные сведения запроса:
      • project_id — идентификатор проекта, полученный от ECommPay при интеграции;
      • payment_id — идентификатор платежа, уникальный в рамках проекта мерчанта;
      • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Работа с подписью к данным);
    • payment — объект, содержащий сведения о переводе:
      • recipient_amount — сумма, зачисляемая на платёжную карту получателя, в минорных единицах валюты;
      • recipient_currency — код валюты для зачисляемой суммы в формате ISO-4217 alpha-3.
    • customer — объект, содержащий сведения об отправителе:
      • id — идентификатор пользователя (отправителя) в рамках проекта мерчанта;
      • ip_address — используемый IP-адрес;
      • country — страна адреса пользователя в формате ISO 3166-1 alpha-2;
      • city — город проживания (или иной населенный пункт);
      • first_name — имя пользователя;
      • last_name — фамилия пользователя;
      • zip — почтовый индекс пользователя;
      • address — адрес проживания.
  3. В запросе должны содержаться сведения о платёжной карте получателя:
    • При передаче реквизитов в явном виде — следующие данные в объекте recipient:
      • pan — номер платёжной карты получателя;
      • card_holder — имя и фамилия получателя (в соответствии с указанными на карте);
    • При передаче токена — объект recipient с параметром token.
  4. В запросе должны содержаться сведения о платёжном инструменте отправителя: в объекте sender передаётся либо номер карты в параметре pan, либо номер кошелька, который может использоваться в сокращённой схеме перевода, в параметре wallet_id.
  5. Дополнительно могут использоваться любые другие параметры, указанные в спецификации.

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

Рис.: Пример тела запроса на зачисление в рамках перевода

{
  "general":{
    "project_id":91348,
    "payment_id":"135113521354",
    "signature":"iehD3ZeW3CM7aGfmdgfjdgneHbCmronMpXom1b/ot1HvOGMV+CT8LA=="
  },
  "customer":{
    "id":"16061313",
    "ip_address":"93.47.230.225",
    "first_name":"Gio",
    "last_name":"Boccaccio",
    "country":"IT",
    "city":"Florence",
    "zip":"50052",
    "address":"Via Certaldo 18"
  },
  "payment":{
    "transfer_type":"out",
    "recipient_amount":100,
    "recipient_currency":"EUR"
  },
//при передаче реквизитов карты получателя в явном виде:
  "recipient":{
    "pan":"5484381034771304",
    "card_holder":"Fran Petrarca"
  },
//при передаче токена:
  "recipient":{
    "token": 1f0dc354c1907a13ba5efc4b19a071b3f1c364abd071bac91b354190b713
  },
//при передаче реквизитов карты отправителя:
"sender":{
    "pan":"4276381374757433"
  }
//при передаче сведений о счёте отправителя:
"sender":{
    "wallet_id":"WID16061313" 
  }
}

Формат запроса на отмену списания

При формировании запросов необходимо учитывать следующее:

  1. POST-запрос должен отправляться к конечной точке /v2/payment/card/money_transfer/in/refund
  2. В запросе должен использоваться объект general, содержащий основные идентификационные сведения запроса:
    • project_id — идентификатор проекта, полученный от ECommPay при интеграции;
    • payment_id — идентификатор платежа, для которого необходимо отменить списание;
    • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Работа с подписью к данным)
  3. Дополнительно могут использоваться любые другие параметры, указанные в спецификации.

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

{
  "general":{
    "project_id":91348,
    "payment_id":"135113521354",
    "signature":"iehD3ZeW3CM7aGfmdgfjdgneHbCmronMpXom1b/ot1HvOGMV+CT8LA=="
  }
}

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

Для оповещения о результате проведения перевода с карты на карту используется стандартный формат, описание которого представлено в разделе Оповещения. Помимо информации о состоянии платежа и инициированных в рамках этого платежа операций, в оповещении содержатся данные о суммах списания и зачисления, а также сведения о платёжных картах отправителя и получателя перевода в объекте account объектов sender и recipient соответственно. В этих объектах передаются параметры type, указывающие типы платёжных карт, которые использовались при отправке и получении перевода. Следующие значения этого параметра могут указываться в рамках проведения платежа money_transfer:

  • visa;
  • mastercard;
  • maestro.

Базовый вариант

В следующем примере содержится информация о том, что при проведении перевода операция списания была отклонена.

Рис.: Пример тела оповещения при отклонении списания средств

{
   "recipient":{                           //сведения о получателе перевода
      "account":{
         "number":"473121******1778",
         "type":"visa",                    //сведения о типе карты получателя
         "card_holder":"GREG KVITKA",
         "id":18111778,
         "country":"UA",
         "product_name":"Visa Rewards",
         "issuer_name":"JSC CB Privatbank"
      }
   },
   "sender":{                              //сведения об отправителе перевода
      "account":{
         "number":"453912******1819",
         "type":"visa",                    //сведения о типе карты отправителя
         "card_holder":"PANTOLEON KULISH",
         "id":26071819,
         "expiry_month":"02",
         "expiry_year":"2024",
         "country":"UA",
         "product_name":"Visa Rewards",
         "issuer_name":"JSC CB Privatbank"
      }
   },
   "customer":{
      "id":"PK-184732WarStPT39"
   },
   "payment":{
      "date":"2019-10-08T18:52:54+0000",
      "id":"18161821",
      "method":"card",
      "status":"decline",                  //статус платежа
      "sum":{                              //сумма и валюта для зачисления
         "amount":1827,
         "currency":"EUR"
      },
      "type":"money_transfer",
      "description":"card2cardtransfer"
   },
   "project_id":91663,
   "operations":[
      {
         "id":1711000007251,
         "type":"sale",                    //статус операции
         "status":"decline",
         "date":"2019-10-08T18:52:54+0000",
         "created_date":"2019-10-08T18:52:19+0000",
         "request_id":"fda091a6bc3b81-069b9fd5abb47bac02-00001712",
         "sum_initial":{                   //сумма списания
            "amount":1836,
            "currency":"EUR"
         },
         "sum_converted":{                 //сумма списания с учётом конвертации
            "amount":8427,
            "currency":"PLN"
         },
         "code":"10102", //операция отклонена по причине некорректно введённых данных
         "message":"Incorrect data entered",
         "eci":"05",
         "provider":{
            "id":2,
            "payment_id":"18161821",
            "auth_code":"331040",
            "endpoint_id":2,
            "date":"2019-10-08T18:52:53+0000"
         }
      },
      {
         "id":1711000007252,
         "type":"payout",
         "status":"decline",                //статус операции
         "date":"2019-10-08T18:52:54+0000",
         "created_date":"2019-10-08T18:52:19+0000",
         "request_id":"fda091ae66bc52e587a81-069b9fd5b47bac02-00001712",
         "sum_initial":{                    //сумма зачисления                  
            "amount":1827,
            "currency":"EUR"
         },
         "sum_converted":{               //сумма зачисления с учётом конвертации       
            "amount":1827,
            "currency":"EUR"
         },
         "code":"100",
         "message":"General decline",
         "provider":{
            "id":2
         }
      }
   ],
   "signature":"hQAYY7mMIeAbeT234Ka26PaXSdm8ptxuEq/g=="
}

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

Рис.: Пример тела оповещения при отклонении зачисления средств

{
   "recipient":{                           //сведения о получателе перевода
      "account":{
         "number":"473121******1778",
         "type":"visa",                    //сведения о типе карты получателя
         "card_holder":"GREG KVITKA",
         "id":18111778,
         "country":"UA",
         "product_name":"Visa Rewards",
         "issuer_name":"JSC CB Privatbank"
      }
   },
    "sender":{                              //сведения об отправителе перевода
      "account":{
         "number":"453912******1819",
         "token": "c398469b3a88edb366b8b0407c084a8ead0c7fa88233d453d",
         "type":"visa",                     //сведения о типе карты отправителя
         "card_holder":"PANTOLEON KULISH",
         "id":26071819,
         "expiry_month":"02",
         "expiry_year":"2024",
         "country":"UA",
         "product_name":"Visa Rewards",
         "issuer_name":"JSC CB Privatbank"
      }
   },
    "customer":{
      "id":"PK-184732WarStPT39"
   },
   "payment":{
      "date":"2019-10-08T18:52:54+0000",
      "id":"18641868",
      "method":"card",
      "status":"reversed",                    //статус платежа
      "sum":{                                 //сумма и валюта для зачисления
         "amount":0,
         "currency":"EUR"
      },
      "type":"money_transfer",
      "description":"card2cardtransfer"
   },
   "project_id":91663,
   "operations":[
      {
         "id":1711000007251,
         "type":"sale",                       //статус операции
         "status":"success",
         "date":"2019-10-08T18:52:54+0000",
         "created_date":"2019-10-08T18:52:19+0000",
         "request_id":"fda091ae6387af268ef81-069b9fd57bac02-00001712",
         "sum_initial":{                      //сумма списания
            "amount":1897,
            "currency":"EUR"
         },
         "sum_converted":{                //сумма списания с учётом конвертации      
            "amount":8707,
            "currency":"PLN"
         },
         "code":"0",
         "message":"Success",   
         "eci":"05",
         "provider":{
            "id":2,
            "payment_id":"18641868",
            "auth_code":"331040",
            "endpoint_id":2,
            "date":"2019-10-08T18:52:53+0000"
         }
      },
      {
         "id":1711000007252,
         "type":"payout",
         "status":"decline",            //статус операции
         "date":"2019-10-08T18:52:54+0000",
         "created_date":"2019-10-08T18:52:19+0000",
         "request_id":"fda091ae66bc387af268ef81-069b9fd5ab4639898b47bac02-00001712",
         "sum_initial":{                 //сумма зачисления
            "amount":1856,
            "currency":"EUR"
         },
         "sum_converted":{               //сумма зачисления с учётом конвертации
            "amount":1856,
            "currency":"EUR"
         },
         "code":"100",
         "message":"General decline",
         "provider":{
            "id":2,
            "payment_id":"18641868",
            "auth_code":"331041",
            "endpoint_id":2,
            "date":"2019-10-08T18:53:53+0000"
         }
      },
      {
         "id":1711000007253,
         "type":"reversal",
         "status":"success",                //статус операции
         "date":"2019-10-08T18:52:54+0000",
         "created_date":"2019-10-08T18:52:19+0000",
         "request_id":"fda091ae66bc52387af268ef81-069b9fd5ab9b07898b47bac02-00001712",
         "sum_initial":{                    //сумма списания
            "amount":1897,
            "currency":"EUR"
         },
         "sum_converted":{                 //сумма списания с учётом конвертации
            "amount":8707,
            "currency":"PLN"
         },
         "code":"0",
         "message":"Success",
         "provider":{
            "id":2,
            "payment_id":"18641868",
            "endpoint_id":2,
            "date":"2019-10-08T18:55:53+0000"
         }
      }
   ],
   "signature":"hQAYY7mMIelgkBWPrBmfFaxNxzaskXE/TiUZ8ptxuEq/g=="
}

В следующем примере содержится информация об успешном проведении перевода.

Рис.: Пример тела оповещения при успешном проведении перевода

{
   "recipient":{                           //сведения о получателе перевода
      "account":{
         "number":"473121******1778",
         "type":"visa",                    //сведения о типе карты получателя
         "card_holder":"GREG KVITKA",
         "id":18111778,
         "country":"UA",
         "product_name":"Visa Rewards",
         "issuer_name":"JSC CB Privatbank"
      }
   },
    "sender":{                              //сведения об отправителе перевода
      "account":{
         "number":"453912******1819",
         "token": "c398469b3a88edb366b8b0407c084a8ead0c7fa88233d453d",
         "type":"visa",                     //сведения о типе карты отправителя
         "card_holder":"PANTOLEON KULISH",
         "id":26071819,
         "expiry_month":"02",
         "expiry_year":"2024",
         "country":"UA",
         "product_name":"Visa Rewards",
         "issuer_name":"JSC CB Privatbank"
      }
   },
    "customer":{
      "id":"PK-184732WarStPT39"
   },
  "payment":{
      "date":"2019-10-08T18:52:54+0000",
      "id":"18641868",
      "method":"card",
      "status":"success",                    //статус платежа
      "sum":{                                //сумма и валюта для зачисления
         "amount":1856,
         "currency":"EUR"
      },
      "type":"money_transfer",
      "description":"card2cardtransfer"
   },
   "project_id":91663,
   "operations":[
      {
         "id":1711000007251,
         "type":"sale",                      //статус операции
         "status":"success",
         "date":"2019-10-08T18:52:54+0000",
         "created_date":"2019-10-08T18:52:19+0000",
         "request_id":"fda091ae6387af268ef81-069b9fd57bac02-00001712",
         "sum_initial":{                     //сумма списания
            "amount":1897,
            "currency":"EUR"
         },
         "sum_converted":{               //сумма списания с учётом конвертации      
            "amount":8707,
            "currency":"PLN"
         },
         "code":"0",
         "message":"Success",   
         "eci":"05",
         "provider":{
            "id":2,
            "payment_id":"18641868",
            "auth_code":"331040",
            "endpoint_id":2,
            "date":"2019-10-08T18:52:53+0000"
         }
      },
      {
         "id":1711000007252,
         "type":"payout",
         "status":"success",                  //статус операции      
         "date":"2019-10-08T18:52:54+0000",
         "created_date":"2019-10-08T18:52:19+0000",
         "request_id":"fda091ae66b8387af268ef81-069b9fd5ab46392fc15e3c02-00001712",
          "sum_initial":{                     //сумма зачисления
            "amount":1856,
            "currency":"EUR"
         },
         "sum_converted":{               //сумма зачисления с учётом конвертации
            "amount":1856,
            "currency":"EUR"
         },
         "code":"0",
         "message":"Success",
         "provider":{
            "id":2,
            "payment_id":"18641868",
            "auth_code":"331040",
            "endpoint_id":2,
            "date":"2019-10-08T18:53:53+0000"
          }
      }
   ],
   "signature":"hQAYY7mMIBWPaskXE/TiUZ26dm8ptxuEq/g=="
}

Сокращённый вариант

В следующем примере содержится информация о выполненном списании средств в рамках сокращённого варианта перевода.

Рис.: Пример тела оповещения при выполнении списания

{
  "project_id":91663,
  "payment":{
    "id":"18641868",
    "type":"money_transfer",
    "status":"success",                           //статус платежа
    "date":"2020-10-08T18:52:54+0000",
    "method":"card",
    "sum":{                                       //сумма и валюта платежа
      "amount":1856,
      "currency":"EUR"
    },
    "description":"card2cardtransfer"
  },
  "customer":{
    "id":"PK-184732WarStPT39"
  },
  "avs_result":"X",
  "tran_region":"domestic",
  "sender":{                                      //сведения об отправителе перевода
    "account":{
      "number":"453912******1819",
      "type":"visa",
      "card_holder":"PANTOLEON KULISH",
      "country":"UA",
      "product_name":"Visa Rewards",
      "issuer_name":"JSC CB Privatbank",
      "expiry_month":"02",
      "expiry_year":"2024",
      "id":26071819,
      "token":"c398469b3a88edb366b8b0407c084a8ead0c7fa88233d453d"
    }
  },
  "operations":[
    {
      "id":1711000007251,
      "type":"sale",
      "status":"success",                         //статус операции
      "date":"2020-10-08T18:52:54+0000",
      "created_date":"2020-10-08T18:52:19+0000",
      "request_id":"fda091ae66b8387af268ef81-069b9fd5ab46392fc15e3c02-00001712",
      "code":"0",
      "message":"Success",
      "provider":{
        "id":2,
        "payment_id":"18641868",
        "auth_code":"331040",
        "endpoint_id":2,
        "date":"2020-10-08T18:52:54+0000"
      },
      "sum_initial":{                             //сумма списания
        "amount":1856,
        "currency":"EUR"
      },
      "sum_converted":{
        "amount":1856,
        "currency":"EUR"
      },
      "region":"domestic",
      "rrn":"000218401850"
    }
  ],
  "signature":"hQAYY7mMIBWPaskXE/TiUZ26dm8ptxuEq/g=="
}

В следующем примере содержится информация о выполненном зачислении средств в рамках сокращённого варианта перевода.

Рис.: Пример тела оповещения при выполнении зачисления

{
    "project_id": 91663,
    "payment": {
      "id": "18641868",
      "type": "money_transfer",
      "status": "success",                         //статус платежа
      "date": "2020-10-08T18:52:54+0000",
      "method": "card",
      "sum": {                                     //сумма и валюта платежа
        "amount": 1856,
        "currency": "EUR"
      },
      "description": "card2cardtransfer"
    },
    "customer": {
      "id": "PK-184732WarStPT39"
    },
    "tran_region": "intereuropean",
    "recipient": {                                 //сведения о получателе перевода
      "account": {
        "number": "473121******1778",
        "type": "visa",
        "card_holder": "GREG KVITKA",
        "country": "UA",
        "product_name": "Visa Rewards",
        "issuer_name": "JSC CB Privatbank",
        "expiry_month": "03",
        "expiry_year": "2025",
        "id": 18111778
      }
    },
    "operations": [
      {
        "id": 1711000007252,
        "type": "payout",
        "status": "success",                       //статус операции
        "date": "2020-10-08T18:52:54+0000",
        "created_date": "2020-10-08T18:52:19+0000",
        "request_id": "fda091ae66b8387af268ef81-069b9fd5ab46392fc15e3c02-00001712",
        "code": "0",
        "message": "Success",
        "provider": {
          "id":2,
          "payment_id": "18641868",
          "auth_code": "331040",
          "endpoint_id": 2,
          "date": "2020-10-08T18:53:53+0000"
        },
        "sum_initial": {                           //сумма зачисления
          "amount": 1856,
          "currency": "EUR"
        },
        "sum_converted": {
          "amount": 1856,
          "currency": "EUR"
        },
        "region": "intereuropean",
        "rrn": "000218401856"
      }
    ],
    "signature": "hQAYY7mMIBWPaskXE/TiUZ26dm8ptxuEq/g=="
  }

Формат оповещения об отмене списания

Сведения о результате выполнения запроса на отмену списания в рамках сокращённого варианта перевода с карты на карту передаются в оповещении стандартного формата с информацей о состоянии платежа и инициированных в рамках этого платежа операций, сумме списания и платёжной карте отправителя в объекте sender.

В следующем примере содержится информация о выполненной отмене списания в рамках сокращённого варианта перевода.

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

{
  "project_id":91663,
  "payment":{
    "id":"18641868",
    "type":"money_transfer",
    "status":"reversed",                           //статус платежа
    "date":"2020-10-08T18:52:54+0000",
    "method":"card",
    "sum":{                                        //сумма и валюта платежа
      "amount":0,
      "currency":"EUR"
    },
    "description":"card2cardtransfer"
  },
  "customer":{
    "id":"PK-184732WarStPT39"
  },
  "avs_result":"X",
  "tran_region":"intereuropean",
  "sender":{                                       //сведения об отправителе перевода
    "account":{
      "number":"453912******1819",
      "type":"visa",
      "card_holder":"PANTOLEON KULISH",
      "country":"UA",
      "product_name":"Visa Rewards",
      "issuer_name":"JSC CB Privatbank",
      "expiry_month":"02",
      "expiry_year":"2024",
      "id":26071819
    }
  },
  "operations":[
    {
      "id":1711000007251,
      "type":"sale",                               //статус операции
      "status":"success",
      "date":"2020-10-08T18:52:54+0000",
      "created_date":"2020-10-08T18:52:19+0000",
      "request_id":"fda091ae66b8387af268ef81-069b9fd5ab46392fc15e3c02-00001712",
      "code":"0",
      "message":"Success",
      "provider":{
        "id":2,
        "payment_id":"18641868",
        "auth_code":"331040",
        "endpoint_id":2,
        "date":"2020-10-08T18:52:54+0000"
      },
      "sum_initial":{                              //сумма списания
        "amount":1856,
        "currency":"EUR"
      },
      "sum_converted":{
        "amount":1856,
        "currency":"EUR"
      },
      "region":"intereuropean",
      "rrn":"000218401850"
    },
    {
      "id":1711000007253,
      "type":"reversal",
      "status":"success",                      //статус операции
      "date":"2020-10-08T18:58:24+0000",
      "created_date":"2020-10-08T18:58:12+0000",
      "request_id":"fda091ae66b8387af268ef81-069b9fd5ab46392fc15e3c02-00001712",
      "code":"0",
      "message":"Success",
      "provider":{
        "id":2,
        "payment_id":"18641868",
        "endpoint_id":2,
        "date":"2020-10-08T18:58:24+0000"
      },
      "sum_initial":{               //сумма, которую необходимо вернуть отправителю
        "amount":1856,
        "currency":"EUR"
      },
      "sum_converted":{
        "amount":1856,
        "currency":"EUR"
      },
      "region":"intereuropean",
      "rrn":"000218401850"
    }
  ],
  "signature":"hQAYY7mMIBWPaskXE/TiUZ26dm8ptxuEq/g=="
}

В следующем примере содержится информация об отклонении отмены списания.

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

{
  "project_id":91663,
  "payment":{
    "id":"18641868",
    "type":"money_transfer",
    "status":"success",                            //статус платежа
    "date":"2020-10-08T18:52:54+0000",
    "method":"card",
    "sum":{                                        //сумма и валюта платежа
      "amount":1856,
      "currency":"EUR"
    },
    "description":"card2cardtransfer"
  },
  "customer":{
    "id":"PK-184732WarStPT39"
  },
  "avs_result":"X",
  "tran_region":"intereuropean",
  "sender":{                                       //сведения об отправителе перевода
    "account":{
      "number":"453912******1819",
      "type":"visa",
      "card_holder":"PANTOLEON KULISH",
      "country":"UA",
      "product_name":"Visa Rewards",
      "issuer_name":"JSC CB Privatbank",
      "expiry_month":"02",
      "expiry_year":"2024",
      "id":26071819
    }
  },
  "operations":[
    {
      "id":1711000007251,
      "type":"sale",
      "status":"success",                         //статус операции
      "date":"2020-10-08T18:52:54+0000",
      "created_date":"2020-10-08T18:52:19+0000",
      "request_id":"fda091ae66b8387af268ef81-069b9fd5ab46392fc15e3c02-00001712",
      "code":"0",
      "message":"Success",
      "provider":{
        "id":2,
        "payment_id":"18641868",
        "auth_code":"331040",
        "endpoint_id":2,
        "date":"2020-10-08T18:52:54+0000"
      },
      "sum_initial":{                             //сумма списания
        "amount":1856,
        "currency":"EUR"
      },
      "sum_converted":{
        "amount":1856,
        "currency":"EUR"
      },
      "region":"intereuropean",
      "rrn":"000218401850"
    },
    {
      "id":1711000007253,
      "type":"reversal",
      "status":"decline",                               //статус операции
      "date":"2020-10-08T18:58:24+0000",
      "created_date":"2020-10-08T18:58:12+0000",
      "request_id":"fda091ae66b8387af268ef81-069b9fd5ab46392fc15e3c02-00001712",
      "code":"10706",       //выполнение этой операции отклонено эмитентом
      "message":"Refund unavailable for current operation",
      "provider":{
        "id":2,
        "payment_id":"18641868",
        "endpoint_id":2,
        "date":"2020-10-08T18:58:24+0000"
      },
      "sum_initial":{        //сумма, которую необходимо вернуть отправителю
        "amount":1856,
        "currency":"EUR"
      },
      "sum_converted":{
        "amount":1856,
        "currency":"EUR"
      },
      "region":"intereuropean",
      "rrn":"000218401850"
    }
  ],
  "signature":"hQAYY7mMIBWPaskXE/TiUZ26dm8ptxuEq/g=="
}