Merchant FAQ

Do I need to add a wallet in the WooCommerce plugin?

No. The plugin does not collect wallet addresses. Settlement destinations are managed under Wallets & Settlements. WooCommerce uses the active destination for the API key's environment and checkout network.

This is intentional. Store managers should connect the plugin with API keys, while wallet ownership and settlement settings stay inside the merchant dashboard.

Which currency does WooCommerce use?

The plugin uses the WooCommerce order currency. If the order is in USD, Yera Connect creates the checkout session in USD.

If the order is in EUR, the checkout session is created in EUR. The merchant should set the normal store currency in WooCommerce and then test a checkout to confirm the currency shown to the customer.

What does Yera Connect do for my business?

Yera Connect helps merchants accept checkout payments, generate payment links, connect WooCommerce stores, create hosted checkout sessions, track payment sessions, review transactions, manage webhook delivery, and configure settlement destinations from one dashboard.

Is Yera Connect only for WooCommerce?

No. WooCommerce is one supported integration path.

Merchants can also use payment links, hosted checkout, and custom API integrations.

What should I set up first?

Start with:

1. Company profile.
2. Wallets & Settlements for the exact environment and network you will use.
3. API keys.
4. Webhooks.
5. WooCommerce, payment links, hosted checkout, or API integration.
6. Sandbox checkout.

What is the difference between a payment session and a transaction?

A payment session is the checkout attempt.

A transaction is the payment result.

If a customer starts checkout but does not complete payment, you may see a payment session without a successful transaction.

What is a settlement asset?

The settlement asset is what the merchant expects to receive after payment processing.

Example:

Customer checkout currency: USD
Merchant settlement asset: USDC on the selected supported network

Can I choose my settlement asset?

You can configure USDC settlement destinations on Ethereum, Polygon, Base, and Solana. Whether a route can be activated depends on the merchant account, environment, and provider capability.

Can merchants choose the currency used on their webshop?

Yes. WooCommerce merchants choose their store currency in WooCommerce.

Yera Connect follows the actual WooCommerce order currency when creating the checkout session.

Does Yera Connect convert every order to crypto?

Yera Connect separates customer checkout currency from merchant settlement setup. The checkout request uses the order or payment link currency, while the merchant dashboard controls the settlement asset and wallet.

Why is checkout blocked?

Common causes are missing API keys, a disconnected plugin, an unapproved merchant account, a missing compatible settlement destination, incomplete settlement verification, the wrong API mode, or an unreachable Yera Connect API base URL.

The dashboard or plugin should show a clear setup warning when possible.

Why does WooCommerce show a setup error?

WooCommerce may show a setup error when:

1. Public key is missing.
2. Secret key is missing.
3. Test mode does not match the key type.
4. API base URL is wrong.
5. Merchant account is not ready.
6. A compatible settlement destination is missing or not ready.
7. Yera Connect API cannot create a checkout session.

Why did the customer pay but the WooCommerce order did not update?

Check:

1. Payment session status.
2. Linked transaction.
3. Webhook delivery result.
4. WooCommerce order notes.
5. WordPress REST API access.
6. Security plugins or firewall rules.

WooCommerce order updates depend on webhook delivery.

Where do I get my API credentials?

Open:

Dashboard -> Developers -> API Credentials

You will find your Merchant ID, Yera Live API Key, and Security Code there. The Live API Key unlocks after your account is approved.

What is the Merchant ID?

The Merchant ID identifies your merchant account. It is safe to share with your developer.

What is the Yera API Key?

The Yera API Key authenticates your plugin or server-side integration. Only keys starting with yera_live_ authenticate new requests; historical Test keys cannot be reused.

Never place an API key in storefront code, browser JavaScript, public GitHub repositories, screenshots, or customer-facing pages.

What is the Security Code?

The Security Code is only needed when you connect or reconnect a website plugin. It is never required for payments.

Where do I download the WooCommerce plugin?

Open:

Dashboard -> Checkout -> Plugins

Then click Download plugin.

What does the WooCommerce plugin do?

The plugin adds Yera Connect to WooCommerce checkout, creates Yera checkout sessions from WooCommerce orders, redirects customers to hosted checkout, receives payment updates, and updates WooCommerce order status when webhook events arrive.

What is the webhook URL?

For WooCommerce, the plugin creates:

https://merchant-store.com/wp-json/yera-connect/v1/webhook

This URL receives payment events from Yera Connect so WordPress can update the matching WooCommerce order.

What is the callback URL?

The callback URL sends the customer back to the merchant store after hosted checkout.

The callback URL helps with the customer experience, but merchants should use webhooks for reliable final payment status.

Do I need both callback URL and webhook URL?

Yes, for WooCommerce and most hosted checkout flows.

The callback URL is for the customer browser.

The webhook URL is for server-to-server payment status updates.

What is mock mode?

Mock mode is for visual testing before the live API or checkout flow is ready.

Mock mode can show sample banners, product messages, cart messages, and checkout notices.

Do not use mock mode for live payment testing.

What is sandbox mode?

Sandbox mode is for testing integration behavior before real customers use checkout.

Use sandbox mode to test keys, checkout redirects, payment sessions, webhook delivery, WooCommerce order updates, and dashboard records.

When can I switch to live mode?

Switch only when:

1. Account is approved.
2. Company profile is complete.
3. The required settlement destination is configured and ready.
4. The settlement asset and network are selected.
5. Live API keys are added.
6. Webhook URL works.
7. Sandbox checkout succeeded.

What should I do if the API URL is not working?

Check the API base URL used by the plugin or backend.

For production, use the confirmed Yera Connect API endpoint. For local or early testing, use mock mode or sandbox mode if the live API endpoint is not ready.

Can staff members use the dashboard?

Yes, if the merchant account gives them access. Limit API key and wallet access to trusted administrators.

What should merchants monitor after going live?

Monitor:

1. Failed payment sessions.
2. Pending sessions.
3. Transactions.
4. Webhook failures.
5. WooCommerce order update issues.
6. Support requests from customers.

What should I test before going live?

1. API keys save correctly.
2. The required settlement destination is configured and ready.
3. The settlement asset and network are selected.
4. Sandbox checkout redirects.
5. Payment session appears in the dashboard.
6. WooCommerce order updates after payment.
7. Webhook logs show successful delivery.

What information should I send support?

Send:

1. Merchant email.
2. Store URL.
3. Payment session ID.
4. Transaction ID.
5. WooCommerce order ID.
6. Webhook event ID.
7. Exact error message.
8. Screenshot if available.

Who do I contact for help?

Email:

support@yeraconnect.io