Как передать ID моего пользователя, чтобы потом найти его в платежах?

Чтобы понимать, кто и что у вас оплатил, передавайте свой идентификатор (ID пользователя, номер заказа — что угодно) через параметр client_reference_id прямо в платёжной ссылке. Значение вернётся к вам вместе с данными об оплате.

Как передать

Добавьте параметр к платёжной ссылке:

https://short.appsign.me/<ваша-ссылка>?client_reference_id=order_12345

Где это вернётся

  • В Telegram-уведомлении об оплате — поле Client Reference ID.

  • В webhook-событии — поле Initial_Checkout_Session.client_reference_id:

{
  "Initial_Checkout_Session": {
    "client_reference_id": "order_12345"
  }
}

Те же данные доступны и при запросе платёжных объектов через EasyPay API.

Разовые оплаты и подписки

  • Для разовых оплат client_reference_id приходит с событием оплаты.

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

💡 Генерируйте уникальное значение на своей стороне — тогда сможете не только узнавать клиента, но и замечать брошенные оплаты: если по вашему client_reference_id не пришло ни удачной, ни неудачной попытки — клиент ушёл со страницы оплаты.

Источники

Внешние ссылки