Перейти к содержанию

Термины и бизнес-сущности

В этом разделе кратко описаны основные термины и бизнес-сущности, которыми оперирует продукт Приём платежей. Общие для explain.qiwi.com термины и бизнес-сущности см. в данной статье.

Счёт

Электронный документ, предназначенный для оплаты заказа. Содержит информацию о сумме и номере заказа. Не является финансовой сущностью и имеет ограниченный срок жизни. Соответствует параметру API billId.

Счёт создаётся только в сценариях c использованием платёжной формы QIWI.

Срок жизни счёта

Если клиент не оплатил счёт в течение определённого времени с момента получения партнёром payUrl, оплата станет недоступна. Срок жизни счёта соответствует параметру API expirationDateTime.

Пример

Для expirationDateTime установлено значение 2023-04-17T14:30:00+03:00. После 14:30:00 17 апреля 2023 года оплатить заказ будет невозможно.

Платёж

Операция списания денежных средств с клиента в пользу партнёра в рамках оплаты заказа. Соответствует параметру API paymentId.

В сценариях с использованием платежной формы QIWI платёж создаётся для оплаты счёта.

Авторизация платежа

В результате авторизации платежа денежные средства клиента резервируются (холдируются, HOLD), но не списываются в пользу партнёра — ожидают подтверждения.

Подтверждение платежа

Соответствует параметру API captureId.

В результате подтверждения платежа захолдированные денежные средства списываются с клиента в пользу партнёра (CAPTURE).

Отмена платежа

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

Возврат по платежу

Соответствует параметру API refundId.

Возврат доступен в случае, когда денежные средства клиента уже списаны в пользу партнёра.

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