Terms and Business Entities¶
In this section, we will provide a brief description of the main terms and business entities used in the Internet Acquiring product. For common terms and business entities applicable to all QIWI products, please refer to this article.
Invoice¶
An electronic document designed for order payment. It contains information about the order amount and number. It is not a financial entity and has a limited lifespan. Maps to the API parameter billId.
An invoice is only created in scenarios using the QIWI payment form.
Invoice Lifespan¶
If the client does not pay the invoice within a certain period after the partner receives the payUrl, the invoice expires and becomes unavailable for payment. The invoice lifespan maps to the API parameter expirationDateTime.
Example
The expirationDateTime is set to 2023-04-17T14:30:00+03:00. After 14:30:00 on April 17, 2023, it will be impossible to pay the order.
Payment¶
The transaction of debiting money from the client in favor of the partner for order payment. Maps to the API parameter paymentId.
In scenarios using the QIWI payment form, the paymentId is created for invoice payment.
Payment Authorization¶
As a result of payment authorization, the client’s funds are held (HOLD) but not debited in favor of the partner, awaiting confirmation.
Payment Confirmation¶
Payment capture. Maps to the API parameter captureId.
As a result of payment confirmation (CAPTURE), the held funds are debited from the client in favor of the partner.
Payment Reversal¶
Reversal is available when the client’s funds are held, and the actual debiting has not been made yet. As a result of the reversal transaction (REVERSAL), the hold is canceled, and the funds become immediately available to the client.
Payment Refund¶
Maps to the API parameter refundId.
Refund is available when the client’s funds have already been debited in favor of the partner.
As a result of the refund transaction, a separate financial transaction is created with a reference to the original payment, which credits the money to the client’s account within a certain number of banking days (REFUND).
Payment Aggregator¶
A credit organization that:
- Provides a business with a service for accepting payments in various ways.
- Consolidates the received payments on its settlement account and then transfers them to the acquiring bank.
Payment Service Provider¶
A provider of electronic payment services (also known as PSP, Payment service provider) – a company with its own hardware and software complex that allows it to independently route payments without an intermediary like an aggregator. The provider does not handle settlements; this is done by the acquiring bank.