Термины и бизнес-сущности¶
В этом разделе кратко описаны основные термины и бизнес-сущности, которыми оперирует продукт Приём платежей. Общие для 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).