Оплата по ссылке: платёжная ссылка для заказов из мессенджеров, соцсетей и по счёту

Как работает оплата по ссылке

Платёжная ссылка — это адрес готовой страницы оплаты Paycryp, привязанный к одному счёту: сумма, описание и срок действия зафиксированы при создании. Клиенту не нужно ничего устанавливать и регистрироваться: он открывает ссылку в браузере на телефоне или компьютере, видит сумму и назначение и выбирает, как платить — по СБП из банковского приложения, банковской картой или в криптовалюте.

Ссылку можно получить двумя способами. Первый — вручную: сотрудник открывает терминал в кабинете или в смартфоне, вводит сумму и описание заказа и копирует ссылку. Так принимают оплату по ссылке за заказ из переписки, счёт клиенту или продажу по телефону. Второй — автоматически: сервер сайта или бота создаёт платёж через Merchant API и получает в ответе paymentUrl — ту же платёжную ссылку, только созданную кодом. Оба способа ведут на одну и ту же страницу оплаты и одинаково видны в истории кабинета.

Оплаченный счёт нельзя перепутать с открытой страницей: пока клиент не завершил платёж, счёт остаётся в статусе «ожидает оплаты». Подтверждённый статус вы видите в кабинете, а сервер сайта получает подписанный вебхук. Выручка после комиссии конвертируется в USDT и доступна к выводу на следующий день, сразу после конвертации, по заявке.

Где пригодится оплата по ссылке

Мессенджеры и соцсети

Заказ пришёл в Telegram, WhatsApp, VK или в комментарии к посту — сотрудник создаёт счёт на согласованную сумму и отправляет ссылку прямо в диалог. Клиент платит, не покидая переписки, а вы видите подтверждение в кабинете и отправляете товар или доступ. Для Telegram-проектов действует одно правило: цифровые товары и услуги внутри бота или Mini App оплачиваются Telegram Stars по правилам Telegram, а Paycryp принимает оплату на сайте проекта, куда ведёт бот.

Счёт клиенту

Вместо счёта в PDF с реквизитами вы отправляете ссылку: в ней уже есть сумма, назначение и срок оплаты. Клиенту не нужно вводить реквизиты вручную, а вам — сверять поступления по назначению платежа: каждый счёт виден в истории отдельной строкой с номером и статусом. Если срок счёта закончился, а клиент так и не оплатил, создайте новый счёт — старая ссылка больше не принимает оплату.

Заказ по телефону

Клиент позвонил, менеджер согласовал состав и сумму заказа. Пока идёт разговор, менеджер создаёт счёт в терминале и отправляет ссылку в SMS или мессенджер. Клиент оплачивает, менеджер проверяет статус в кабинете и подтверждает заказ. Скриншот из банковского приложения для подтверждения не нужен — решает статус счёта в кабинете.

Самозанятые и частные лица

Подключиться к Paycryp может любой: компания, ИП или частное лицо. Стандартное подключение идёт онлайн, без паспортной анкеты и бумажного договора. Репетитору, мастеру или консультанту достаточно терминала в смартфоне: ввели сумму, отправили ссылку клиенту, увидели подтверждение. Сайт для этого не обязателен.

Как создать платёжную ссылку через API

Если заказы оформляются на сайте, в приложении или в боте, ссылку создаёт ваш сервер. Ключ онлайн-терминала из кабинета передаётся в заголовке Authorization и хранится только на сервере — в браузер и публичный код он не попадает. Сумма указывается в минорных единицах валюты терминала: 150000 — это 1 500 ₽ (сумма учебная). orderId — номер заказа в вашей системе; повторный запрос с тем же orderId и той же суммой вернёт уже созданный платёж, а не второй счёт.

POST /api/v1/payments HTTP/1.1
Host: api.paycryp.app
Authorization: Bearer <ключ терминала>
Content-Type: application/json

{
  "amount": 150000,
  "description": "Заказ №1024",
  "orderId": "1024",
  "method": "CHOICE"
}

В ответе — объект платежа. Поле paymentUrl и есть платёжная ссылка: отправьте её клиенту или перенаправьте на неё покупателя. expiresAt показывает, до какого момента ссылка действует.

{
  "id": "3f1c9a2e-5b7d-4e8f-9a1b-2c3d4e5f6a7b",
  "orderId": "1024",
  "status": "PENDING",
  "amount": 150000,
  "currency": "RUB",
  "paymentUrl": "https://app.paycryp.app/p/3f1c9a2e-5b7d-4e8f-9a1b-2c3d4e5f6a7b",
  "expiresAt": "2026-07-21T10:30:00.000Z"
}

method: "CHOICE" оставляет выбор способа покупателю; значения SBP или CRYPTO фиксируют один способ. Полное описание полей, статусов, вебхуков и проверки подписи — в документации Merchant API, а пошаговый разбор интеграции — в статье как подключить оплату на сайте.

Сколько действует ссылка на оплату

Срок действия задаётся в настройках терминала и применяется ко всем новым счетам этого терминала: от 5 минут до 30 дней, по умолчанию 30 минут. Для заказов из переписки и счетов клиентам обычно выбирают длинный срок, для витрины с резервом товара — короткий. Дата окончания возвращается в поле expiresAt и видна в карточке счёта в кабинете. Изменение настройки не затрагивает уже выставленные счета: у них остаётся срок, зафиксированный при создании.

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

Как узнать, что клиент оплатил

Для ручных ссылок достаточно кабинета: в истории терминала счёт меняет статус на «оплачен», видны сумма, время и номер. Именно этот статус — основание отправить товар или открыть доступ. Открытая клиентом страница, экран «успешно» и скриншот из банка сами по себе оплату не подтверждают.

Для ссылок, созданных через Merchant API, Paycryp отправляет на Webhook URL терминала подписанное событие payment.confirmed. Сервер проверяет подпись, сверяет orderId, валюту и baseAmount с исходным заказом и выдаёт заказ один раз. Если событие задержалось, актуальный статус можно запросить по GET /v1/payments/order/{orderId}. Подтверждённая оплата учитывается, даже если она пришла после истечения или отмены счёта, — интеграция должна принимать такое событие.

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