WooCommerce setup

The WooCommerce setup page gives merchants a checklist and plugin download for connecting a WordPress WooCommerce store to Yera Connect.

Use this page when the merchant wants Yera Connect to appear as a WooCommerce payment method and create Yera hosted checkout sessions from WooCommerce orders.

Setup checklist

1. Download the Yera Connect WooCommerce plugin.
2. Install the plugin in WordPress.
3. Activate the plugin.
4. Open WooCommerce -> Settings -> Payments -> Yera Connect Pay.
5. Enable Yera Connect Pay.
6. Add the Yera Connect public key.
7. Add the Yera Connect secret key.
8. Add the webhook secret.
9. Keep customer country detection on auto unless support tells you to use manual mode.
10. Run a sandbox checkout.

What each setup item means

Download the plugin:

Get the ZIP file from the Yera Connect dashboard and install it through WordPress Admin.

Install the plugin:

Upload the ZIP in WordPress Admin under Plugins, then install it.

Activate the plugin:

After activation, WordPress shows Yera Connect Pay under WooCommerce payment settings.

Open gateway settings:

Go to WooCommerce -> Settings -> Payments -> Yera Connect Pay.

Enable Yera Connect Pay:

Turn on the payment method so customers can choose Yera Connect during checkout.

Add public key:

The public key identifies the merchant integration.

Add secret key:

The secret key authenticates secure server-side requests from WordPress to Yera Connect.

Webhook URL:

The WordPress webhook URL is generated automatically in the plugin settings. The plugin sends it to Yera Connect when it creates checkout sessions.

Webhook secret:

Paste the webhook secret into the plugin settings. WordPress uses it to verify payment status updates from Yera Connect.

Country detection:

Auto detection uses the WooCommerce billing country, then shipping country, then the store country. Manual mode should only be used when support asks for a fixed fallback country.

Sandbox test checkout:

This confirms the full flow works before live payments are enabled.

Important behavior

The plugin follows the WooCommerce order currency. If a store order is USD, the Yera checkout session is created in USD.

The wallet is managed in the Yera Connect dashboard, not inside the plugin.

Store notification behavior

If setup is incomplete, the merchant should receive a clear notice in WordPress or checkout.

Common setup warnings include:

1. Missing public key.
2. Missing secret key.
3. Plugin disconnected.
4. WooCommerce inactive.
5. Merchant account not ready.
6. Missing verified dashboard wallet.
7. Webhook secret missing or invalid.
8. Webhook delivery issue.
9. API connection failure.

The plugin should fail safely and avoid sending customers into a broken checkout flow.

Sandbox test direction

To test WooCommerce:

1. Enable sandbox or test mode.
2. Add the sandbox public key and secret key.
3. Confirm the API base URL points to Yera Connect.
4. Add the webhook secret.
5. Keep customer country detection on auto.
6. Add a product to cart.
7. Go to checkout.
8. Choose Yera Connect as the payment method.
9. Place the order.
10. Confirm redirect to Yera checkout.
11. Complete the sandbox payment.
12. Confirm the WooCommerce order updates.
13. Confirm the payment session appears in the Yera dashboard.
14. Confirm webhook logs show delivery.

More details

Read the WooCommerce integration guide.