Payment via Qplus¶

General Information¶

The partner can implement payment with its own payment form using Qplus. To connect this payment method, please contact our support service.

Qplus Payment Scenario¶

1. The partner creates a payment link and a QR code via a Qplus invoice creation request. The request includes the phone number to which the client’s Qplus is registered.
2. The client follows the link or scans the QR code and completes the payment.

3. The partner can obtain the payment result from two different sources:

   • Invoice Information: call the Qplus invoice information method. This method returns the invoice status and the associated payment.
   • Payment Notification: receive an automated notification on their server. The notification is sent for a specific payment made within the QPlus invoice. The paymentMethod object contains the invoice identifier invoiceUid and the phone number phone linked to the client’s Qplus account.

%%{init: {
    "sequence" : {
        "wrap":true,
        "messageFontSize":14,
        "noteFontSize":12,
        "actorMargin":
        60 }}}%%
sequenceDiagram
    participant C as Client
    participant P as Partner
    participant Q as QIWI
    participant QP as Qplus

    rect rgb(230, 230, 230)
    Note over C, QP: 1. Creating a Qplus Invoice
    end
    C->>P: Selecting a product and Qplus as the payment method
    P->>Q: Invoice creation request
    Q->>+QP: Invoice creation request
    QP->>QP: Invoice creation
    QP->>-Q: Invoice creation response
    Q->>P: Invoice creation response
    Note left of Q: invoiceStatus:CREATED, paymentUrl, qrCode
    P->>C: Providing the payment link and the QR code

    rect rgb(230, 230, 230)
    Note over C, QP: 2. Paying a Qplus Invoice
    end
    C->>QP: Customer follows the Qplus payment link or scans the QR code to complete the payment

    rect rgb(230, 230, 230)
    Note over P, QP: 3. Obtaining the payment result (2 options)
    end
    QP->>Q: Obtaining the payment result
    P->>+Q: 1: Invoice Information Polling
    Q->>-P: Invoice Information Response
    Note left of Q: Invoice data + payment object (includes paymentId and payment status)
    Q->>P: 2: Payment Notifications
    Note left of Q: Contains invoiceUid, phone, paymentId, and payment status

Retrieving Detailed Qplus Payment Information¶

To retrieve detailed information about a specific transaction, use the payment details method.

The paymentId value can be extracted either from the payment object in the Qplus invoice information response or directly from the payment notification body.

The paymentMethod object contains the invoice identifier invoiceUid and the phone number phone linked to the client’s Qplus account.

Processing a Qplus Refund¶

To process a refund, use the refund creation method, specifying the paymentId.