Merchant FAQ

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

No. Wallets are managed inside the Yera Connect dashboard. The plugin uses the merchant's verified default dashboard wallet.

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 wallet settings 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. Wallet settings.
3. Settlement asset.
4. API keys.
5. Webhooks.
6. WooCommerce, payment links, hosted checkout, or API integration.
7. 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 Polygon

Can I choose my settlement asset?

Yes, when supported by the merchant account and provider route. The current recommended setup is USDC on Polygon.

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, disconnected plugin, unapproved merchant account, missing verified wallet, 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. Wallet is missing or unverified.
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 API keys?

Open:

Dashboard -> API Keys

Create test keys for sandbox. Create live keys only when the account is ready for production.

What is the public key?

The public key identifies the merchant integration.

What is the secret key?

The secret key authenticates secure server-side requests.

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

Where do I download the WooCommerce plugin?

Open:

Dashboard -> WooCommerce Setup

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. Wallet is verified.
4. Settlement asset is 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. Wallet is verified.
3. Settlement asset is 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