Sandbox and live mode

Understand how test mode, live mode, account review, and merchant readiness work.

Sandbox mode is for testing integration behavior without relying on a real production checkout.

Live mode is for real customers and real merchant payment operations.

Merchants should always start in sandbox mode. The purpose of sandbox mode is to prove that the account, keys, settlement configuration, checkout flow, order update logic, and webhook delivery all work before real customers use the checkout.

Sandbox mode

Use sandbox mode to test:

  1. WooCommerce plugin connection
  2. API key setup
  3. Checkout session creation
  4. Payment link creation
  5. Webhook delivery
  6. Order status mapping
  7. Dashboard reporting

Sandbox testing should include both successful and failed flows. A merchant should know what the customer sees, what the dashboard records, and what WooCommerce or the backend receives.

Sandbox checklist

  1. Create sandbox keys.
  2. Add keys to the plugin or backend.
  3. Confirm an active Test settlement destination is configured for the selected asset and network under Wallets & Settlements.
  4. Create a test order or payment link.
  5. Complete a successful sandbox checkout.
  6. Trigger or simulate a failed checkout.
  7. Check Payment sessions.
  8. Check Transactions.
  9. Check Webhooks.
  10. Confirm the merchant system updates correctly.

Live mode

Before live mode:

  1. Company profile must be complete.
  2. Merchant account must be approved.
  3. The required Live settlement destination must be configured and ready.
  4. Live API keys must be created.
  5. Webhook URL must be reachable.
  6. A low-value test checkout should pass.

Live launch checklist

  1. Disable mock mode.
  2. Disable sandbox or test mode in the live store.
  3. Connect with your Yera Live API Key (keys starting with yera_live_).
  4. Confirm live API base URL.
  5. Confirm live account approval.
  6. Confirm the Live settlement destination is ready.
  7. Confirm settlement asset and network.
  8. Confirm webhook URL.
  9. Run one low-value live checkout.
  10. Check payment session, transaction, and webhook delivery.

Common reason live mode is blocked

Live mode can be blocked when the account is still under review, the required settlement destination is not ready, business details are missing, or the integration is still using a sandbox key.

What merchants should not do

Do not use live keys for sandbox testing.

Do not switch to live mode before webhooks are working.

Do not accept real customer orders if WooCommerce order status is not updating correctly.

We use cookies

Yera Connect uses cookies to keep the website secure, remember preferences, and improve the merchant experience. By selecting Accept, you agree to our Cookie Policy.