Payment Links
Многоразовые точки приёма оплаты. В отличие от платежа, живут постоянно и не привязаны к одной операции: каждое сканирование QR создаёт новый платёж.
Два вида
Что выбрать
link (кассовая ссылка)
object
optional
Постоянный QR или URL без суммы: плательщик вводит её сам. Подходит для кассы, стойки, приёма произвольных платежей.
template (шаблон)
object
optional
Постоянный QR с заранее заданной суммой и основанием. Подходит для фиксированной цены: абонемент, конкретная услуга, товар.
| Name | Type | Required | Description |
|---|---|---|---|
link (кассовая ссылка)
|
object
|
optional | Постоянный QR или URL без суммы: плательщик вводит её сам. Подходит для кассы, стойки, приёма произвольных платежей. |
template (шаблон)
|
object
|
optional | Постоянный QR с заранее заданной суммой и основанием. Подходит для фиксированной цены: абонемент, конкретная услуга, товар. |
Кассовая ссылка
Параметры
name
string
required
Название для ваших нужд, плательщику не показывается.
is_default
boolean
optional
Сделать ссылкой по умолчанию.
| Name | Type | Required | Description |
|---|---|---|---|
name
|
string
|
required | Название для ваших нужд, плательщику не показывается. |
is_default
|
boolean
|
optional | Сделать ссылкой по умолчанию. |
Поля ответа
id
string
optional
Идентификатор ссылки.
state
enum
optional
active, need_activation, not_used, deleted.
url
string
optional
Адрес формы оплаты.
qr_image
string
optional
Изображение QR-кода — его печатают или выводят на экран.
| Name | Type | Required | Description |
|---|---|---|---|
id
|
string
|
optional | Идентификатор ссылки. |
state
|
enum
|
optional | active, need_activation, not_used, deleted. |
url
|
string
|
optional | Адрес формы оплаты. |
qr_image
|
string
|
optional | Изображение QR-кода — его печатают или выводят на экран. |
✦
need_activation — это не ошибка
Свежесозданная ссылка может требовать активации перед первым использованием. Пока состояние не стало active, оплата по ней не пройдёт.
Шаблон
Параметры
name
string
required
Название шаблона.
amount
string
optional
Сумма строкой. Если не указана, плательщик вводит её сам.
description
string
optional
Основание платежа. Попадает в чек и видно плательщику.
| Name | Type | Required | Description |
|---|---|---|---|
name
|
string
|
required | Название шаблона. |
amount
|
string
|
optional | Сумма строкой. Если не указана, плательщик вводит её сам. |
description
|
string
|
optional | Основание платежа. Попадает в чек и видно плательщику. |
Поля ответа
id
string
optional
Идентификатор шаблона.
amount
string
optional
Сумма шаблона.
static_url
string
optional
Постоянный адрес оплаты.
qr_image
string
optional
Изображение QR-кода.
| Name | Type | Required | Description |
|---|---|---|---|
id
|
string
|
optional | Идентификатор шаблона. |
amount
|
string
|
optional | Сумма шаблона. |
static_url
|
string
|
optional | Постоянный адрес оплаты. |
qr_image
|
string
|
optional | Изображение QR-кода. |
Платежи по ссылке
Платежи, созданные через ссылку или шаблон, ничем не отличаются от обычных: те же статусы, те же уведомления, те же возвраты. Разница только в том, что order_id вы не задаёте — его назначает канал, и сопоставлять операцию нужно по идентификатору платежа из уведомления.
⚠
Удаление необратимо
Удалённая ссылка или шаблон перестают принимать оплату немедленно. Напечатанные QR-коды после этого не работают — перевыпустите их до того, как удалять старые.