Уведомление пользователей

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

В платежной платформе Rocketpay поддерживается возможность уведомлять пользователей о различных событиях, связанных с проведением платежей. Как правило, это уведомления о результатах выполнения операций, однако в зависимости от индивидуальных потребностей мерчанта могут использоваться уведомления и о других событиях, например обновлении условий повторяемой оплаты.

Уведомления отправляются при соблюдении следующих условий:

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

К событиям, для которых настраивается отправка уведомлений, могут относиться как результаты выполнения операций в рамках проведения платежей (например, операций sale, auth, capture, cancel, payout и refund), так и результаты отдельных действий, выполненных в рамках операций (например, обновление условий повторяемой оплаты).

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

При необходимости можно выполнять повторную отправку определенных уведомлений. Для этого следует обращаться к специалистам технической поддержки support@rocketpay.kz.

Далее представлена информация о порядке подключения отправки уведомлений, об использовании двух вариантов оформления уведомлений — стандартного и индивидуального, а также о формате данных, передаваемых в запросах на проведение тех платежей, по которым необходимо уведомлять пользователей. Информация об отправке чеков в Payment Page представлена в разделе Отправка чеков пользователю.

Подключение

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

  • перечень операций и других событий, для которых настраивается отправка;
  • статусы операций, при которых выполняется отправка уведомлений (возможно как для итогового статуса success, так и для итогового статуса decline) ;
  • язык уведомления по умолчанию (русский или английский), который применяется в случае, если в запросе на проведение платежа не передан код языка пользователя в параметре customer.language;
  • тема письма, в котором приходит уведомление (например, Receipt или «Уведомление о проведенной оплате»);
  • адрес электронной почты отправителя (домен Rocketpay или домен, принадлежащий веб-сервису мерчанта);
  • возможность отправлять скрытые копии уведомлений на адрес электронной почты, предоставленный мерчантом.

Оформление уведомлений

Стандартное оформление

Стандартный шаблон может использоваться только при отправке уведомлений о результатах выполнения операций в рамках проведения разовых оплат (purchase) и выплат (payout), а также о результатах выполнения возвратов средств пользователям (refund).

Шаблон содержит следующие поля:

  • дату и время, когда событие зафиксировано в платежной платформе, с указанием часового пояса веб-сервиса мерчанта;
  • логотип Rocketpay или мерчанта;
  • название, фактический адрес, а также доменное имя мерчанта;
  • описание: тип платежа или операции, результат которых передается в уведомлении;
  • номер заказа: идентификатор платежа payment_id;
  • метод оплаты: данные платежного инструмента, с использованием которого был проведен платеж;
  • сумму платежа с указанием кода валюты;
  • ссылки на адрес электронной почты и номер телефона службы поддержки мерчанта;
  • ссылку на правила пользования сервисом и условия возврата.

Индивидуальное оформление

Шаблон с индивидуальной версткой может использоваться для отправки уведомлений как о результатах операций, так и о других событиях, связанных с проведением платежей. Индивидуальная верстка таких уведомлений реализуется на стороне Rocketpay на основе макетов, предоставленных мерчантом. В шаблонах с индивидуальной версткой могут использоваться те же элементы, что и в стандартных шаблонах, с возможностью изменения их порядка или могут быть добавлены другие элементы, например блоки с информацией о товарных позициях, о превышении лимита общей суммы операций за сутки или об обновлении условий повторяемой оплаты. Также мерчантам следует учитывать, что в случае нестандартного текста уведомлений и для уведомлений на всех языках, кроме английского и русского, необходимо предоставить текст уведомления специалистам технической поддержки.

Далее представлены примеры уведомлений с индивидуальной версткой:

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

Формат данных

Для отправки уведомления кроме обязательных параметров в запросе необходимо передать:

  • адрес электронной почты пользователя в параметре email объекта customer;
  • код языка пользователя в параметре language объекта customer в случае отправки уведомлений на любых языках, кроме английского и русского.

Для включения в уведомление информации о товарных позициях необходимо дополнительно передать данные для формирования такого уведомления в объекте receipt_data. Объект receipt_data содержит массив positions, в котором можно перечислить до 50 товарных позиций. Для каждой товарной позиции указывается следующее:

  • amount — обязательный параметр для указания стоимости товара;
  • quantity — дополнительный параметр для указания количества товарных единиц;
  • tax — дополнительный параметр для указания ставки налога на добавленную стоимость (НДС);
  • tax_amount — дополнительный параметр для указания суммы налога на добавленную стоимость (НДС);
  • description — дополнительный параметр с описанием товара.

Как правило, в объекте receipt_data также указывается общая сумма НДС за всю покупку в параметре total_tax_amount. Если ставка НДС является одинаковой для всех позиций, то она указывается в параметре common_tax после общей суммы. Если ставка отличается для позиций в списке, то ее значение указывается в параметре tax для каждой позиции отдельно.

Структура JSON-объекта приведена в схеме receiptdata в спецификации Gate API.

В представленном далее примере запроса на проведение оплаты в объекте receipt_data содержится список из трех товарных позиций в массиве positions. Так как ставки НДС для отдельных товаров в списке различаются, они указываются с помощью параметра tax для каждой товарной позиции. Соответственно, параметр common_tax с общей ставкой НДС в данном случае указывать не нужно.

Рис.: Пример запроса на оплату с информацией о товарных позициях

{
  "general":{
    "project_id":92724,
    "payment_id":"ECOMM-7654321-777",
    "signature":"5fgsjhgfgFxO9UaFLYGsBaisdffddgYuezUf+6VWlrsdfsH+LysUfdQM+w=="
  },
  "customer":{
    "ip_address":"128.112.0.16",
    "email":"test@example.com"
  },
  "payment":{
    "amount":131971,
    "currency":"USD",
    "description":"Myshop order"
  },
  "receipt_data":{
    "positions":[             // Массив с перечислением товарных позиций
      {
        "quantity":1,
        "amount":5990,
        "tax":20,            
        "tax_amount":1198,
        "description":"Dance class, a book"
      },
      {
        "quantity":3,
        "amount":2990,
        "tax":10, 
        "tax_amount":299,
        "description":"Dog food, 1-week supply"
      },
      {
        "quantity":1,
        "amount":122990,
        "tax":20,            
        "tax_amount":24598,
        "description":"Radio-controlled Flying Dutchman, full size"
      }
    ],
    "total_tax_amount":26095           
  },
  "card":{
    "pan":"1122334455667788",
    "year":2025,
    "month":11,
    "card_holder":"John Doe"
  }
}