---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.5
alternate:
  - https://pay.yandex.ru/docs/en/custom/integration-guide.md
  - https://pay.yandex.ru/docs/ru/custom/integration-guide.md
  - href: en/custom/integration-guide.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://pay.yandex.ru/docs/en/llms.txt

# Integrating by adding a Yandex Pay button

These integration instructions enable you to add a Yandex Pay button and  widget as shown [in the demo](https://pay.yandex.ru/docs/en/custom/index.md#sequence). To implement the schema with link generation, follow these [instructions](https://pay.yandex.ru/docs/en/custom/integration-guide-link.md).

## Requirements for connecting {#requirements}

Before getting started, [register in the merchant console](https://pay.yandex.ru/docs/en/console/index.md) and set up the test environment.

## Instructions for integrating with {#plan}

To add a Yandex Pay button or widget, follow the SDK instructions for the [Web](https://pay.yandex.ru/docs/en/custom/web-sdk/index.md), [Android](https://pay.yandex.ru/docs/en/custom/android-sdk/index.md), or [iOS](https://pay.yandex.ru/docs/en/custom/ios-sdk.md).

On the backend, you need to implement processing of the incoming requests [/order/render](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/archive/order-render.md), [/order/create](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/archive/order-create.md), and [/webhook](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/webhook.md). The merchant's backend must authenticate requests coming from Yandex Pay by checking a digital signature. Read more in the [section on request authentication](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/index.md#auth) in the Merchant API.

For the order payment mode:

- Use the client SDK to transmit the order ID in the merchant's system using the `orderId` parameter.
- In the [/order/render](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/archive/order-render.md) response, pass the payment method (`availablePaymentMethods`).

In the [/order/render](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/archive/order-render.md) request, the merchant's backend will receive the order ID (`orderId`) transmitted via the SDK. The backend will use this ID to return the cart items and the due amount.

Having received the [order/create](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/archive/order-create.md) request, the merchant's backend collates the order ID and amount due specified in the request with the data in the merchant's system. If the data is correct, the backend returns response code 200 which authorizes the order payment.

To enable Yandex Pay Checkout in the [/order/render](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/archive/order-render.md) response, [enable delivery](https://pay.yandex.ru/docs/en/custom/delivery/index.md). When getting the [/order/create](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/archive/order-create.md) request, create a new order in the merchant system. To enable pickup points, implement the methods [/pickup-options](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/archive/pickup-options.md) and [/pickup-option-details](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/archive/pickup-option-details.md).

For integration testing, install the `Sandbox` environment in the SDK parameters.

## What's next {#next-step}

Read the [branding rules](https://pay.yandex.ru/docs/en/branding.md). If needed, set up transmission of [receipts for the Federal Taxation Services](https://pay.yandex.ru/docs/en/custom/fns.md), implement order management over the [Yandex Pay API](https://pay.yandex.ru/docs/en/custom/backend/merchant-api/index.md) in the merchant's backoffice, and [enable Split](https://pay.yandex.ru/docs/en/custom/split.md). To let your users pay in two steps, set up [two-step payments](https://pay.yandex.ru/docs/en/custom/payment-stages.md).