Connect Yandex Delivery

Yandex Pay enables you to connect to Yandex Delivery using the Yandex Pay form, without technical integration.

To show the Yandex Delivery options to the user in the Yandex Pay Checkout form:

1. In the Yandex Pay console, enable Yandex Delivery integration.
2. In the /order/render response, return the data:
   • The shipping.availableMethods attribute must include YANDEX_DELIVERY.
   • Specify dimensions for each item in the cart.
   • Add the details about the warehouse where the courier can pick up the order to shipping.yandexDelivery.warehouse.

How Yandex Delivery works:

1. When placing an order, the user selects the Yandex Delivery option.
2. Yandex Pay authorizes user payment.
3. The store assembles the order and initiates delivery by the /delivery/create request.
4. Yandex Delivery evaluates the cost, and when the evaluation is complete, the delivery changes its status to READY_FOR_APPROVAL.
5. The store accepts the delivery by the /delivery/accept request within 10 minutes after the evaluation is complete.
   • If more than ten minutes have elapsed, the delivery status changes to EXPIRED.
   • The store can renew the delivery via the /delivery/renew request and return to step 4.
6. The delivery process is initiated:
   • The delivery service receives the order from the merchant.
   • The delivery service delivers the order to the recipient.
   • If it fails to hand the order over to the recipient, it returns the order to the merchant.
7. Yandex Pay notifies the merchant about the delivery status change by calling /webhook.
8. The store can use the /delivery/cancel request to cancel the delivery for free or at a fee depending on the current delivery status. To find out the cancellation options (paid, free, unavailable), see the /delivery/cancel-info response.

When automated delivery confirmation is enabled, Yandex Pay will complete steps 3 and 5 immediately after the payment is authorized successfully.