Payment via Yandex Pay¶

General Information¶

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

Yandex Pay Payment Scenario¶

1. The partner creates a payment link via a Yandex Pay order generation request.
2. The client follows the link and completes the payment.

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

   • Order Information: Call the Yandex Pay order information method. This method returns the order status and a list of associated payments.
   • Payment Notification: Receive an automated notification on their server. The notification is sent for a specific payment made within the Yandex Pay order.

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

    rect rgb(230, 230, 230)
    Note over C, Y: 1. Creating a Yandex Pay Order
    end
    C->>P: Selecting a product and Yandex Pay as the payment method
    P->>Q: Order creation request
    Q->>+Y: Order creation request
    Y->>Y: Order Creation
    Y->>-Q: Order creation response
    Q->>P: Order creation response
    Note left of Q: status:CREATED, paymentUrl
    P->>C: Providing the payment link

    rect rgb(230, 230, 230)
    Note over C, Y: 2. Customer follows the payment link and completes the payment
    end
    C->>Y: Customer follows the Yandex Pay payment link to complete the payment

    rect rgb(230, 230, 230)
    Note over P, Y: 3. Obtaining the payment result (2 options)
    end
    Y->>Q: Obtaining the payment result
    P->>+Q: 1: Order Information Polling
    Q->>-P: Order Information Response
    Note left of Q: Order data + payments array (includes paymentUid and payment status)
    Q->>P: 2: Payment Notifications
    Note left of Q: Contains orderUid, paymentId, and payment status

Retrieving Detailed Yandex Pay Payment Information¶

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

The paymentId value can be extracted either from the payments array in the Yandex Pay order information response or directly from the payment notification body.

Processing a Yandex Pay Refund¶

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