# Как передать 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`:

```json
{
  "Initial_Checkout_Session": {
    "client_reference_id": "order_12345"
  }
}
```

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

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

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

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

## Источники

* [Webhook EasyPay: структура данных платежей Stripe](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/webhook-easypay-struktura-dannyh-platezhej-stripe-2aK80hyqzo)
* [EasyPay API — получение платёжных объектов Stripe](https://docs.thenextgen.store/s/635a43c1-37fa-463b-bc7e-7ede7884fce2/doc/endpoint-poluchenie-platyozhnyh-obuektov-stripe-tu4gaOUuSJ)

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

* [Stripe — Streamline reconciliation with a URL parameter](https://docs.stripe.com/payment-links/url-parameters#streamline-reconciliation-with-a-url-parameter)