---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://pay.yandex.ru/docs/en/cms/opencart/module-setup.md
  - https://pay.yandex.ru/docs/ru/cms/opencart/module-setup.md
  - href: en/cms/opencart/module-setup.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

# Connect and set up the module

1. Go to the OpenCart admin panel.
1. In the side menu, select **Modules/Extensions** → **Modules/Extensions**.
1. In the **Select extension type** section, select **Payment**.

   ![image](_assets/module-type.png)

1. Find the Yandex Pay module on the list and click **+** to enable it.

   ![image](_assets/module-enable.png)

1. Go to the module [settings](#settings). To do this, click the "pencil" icon to the right of the module name.

   ![image](_assets/module-settings.png)

## Module settings {#settings}

### Main settings {#main-settings}

* **API key**: The key for request identification. To manage the keys, go to the [Yandex Pay console](https://console.pay.yandex.ru/settings).
* **Merchant ID**: The ID that the merchant receives when they register in Yandex Pay.
* **Merchant name**: The store name in Yandex Pay.
* **Test mode**: Enable test mode to debug the module. If this option is enabled, money won't be debited from the card.
* **Mode**: Placement options for module components (buy with one click or pay on the order creation page).
* **Take into account the number of items in the cart**: The maximum allowed number of items in the cart.
* **Allow payment on delivery**: Allows payment on delivery in the Yandex Pay Checkout module (buy in one click).
* **Allos comments**: Allows the user to enter comments in the Yandex Pay Checkout module (buy with one click).
* **Allow discount promocodes**: Allows the user to enter a discount promocode in the Yandex Pay Checkout module (buy with one click).
* **Enable Split**: Allows the user to pay in installments.
* **Enable Yandex Delivery**: Allows the user to order delivery.
* **Status**: Enable or disable the module.

### Status settings {#status-settings}

Match the order statuses according to the store settings. Recommended statuses:

* Pending payment: `Pending`.
* Payment for the order has been authorized. The funds on the customer's account have been blocked: `Processing`.
* The order has been paid for successfully. The funds have been withdrawn from the customer's account: `Completed`.
* The payment has been canceled (voided). No money has been charged: `Canceled`.
* The order money has been refunded: `Full refund`.
* The order money has been partially refunded: `Refund`.
* The order payment has failed: `Failed`.

### Appearance settings {#design-settings}

Set up the button design:

* **Selector for the product/cart/order**: CSS selector where the button must be placed in order to be displayed.
* **Display type**: The way the button is displayed. Learn more in [Branding rules](https://pay.yandex.ru/docs/en/branding.md).
* **Button width**: Button size. Acceptable values:

  * **Automatic**: The script sets the optimal button width automatically.
  * **Maximal**: The button fits the block where it's placed.

* **Top/bottom/left/right margin**: The margins around the button in pixels.
* **Free CSS**: Appearance settings for advanced users (developers).

### Other settings {#other-settings}

* **Pickup**: Create pickup (depot) points for the store.
* **Deliveries**: Add the missing data for delivery. The module automatically checks which supported delivery modules the store has installed.
* **Log**: Enables the collection of error data. This is necessary for technical support.