Product Guides
Maya Tech BlogGo to Maya Business Manager

WooCommerce Troubleshooting Guide

🧠 Keep in mind

This troubleshooting guide is for Maya WooCommerce plugin only.

Basic Troubleshooting Steps

  1. Check if the Maya WooCommerce plugin version is the most recent one (v1.1.5). Go to Maya Business Plugin to download the latest version.

⚠️ This is compatible with installed versions of Wordpress (v5.3.2 up to v6.7.1) and WooCommerce (v3.9.3 up to v9.6.0).

  1. Check if Maya Payment Gateway is enabled in WooCommerce dashboard.

ℹ️ As needed, disable/enable Maya Gateway in WooCommerce plugin.

  1. Make sure that the merchant account you are using is enabled to use the Maya Checkout WooCommerce product/solution.
  2. Check API Keys Setup.
  3. Check Webhooks Setup.
  4. Check that the Sandbox Mode setting (should only be enabled if Non-Production); it should be aligned with the Maya Manager environment.

Review API Keys Setup

  1. Make sure that API keys are generated under the merchant account enabled to use the Maya Checkout WooCommerce product/solution (see Maya Manager merchant account’s API keys setup).

  2. Check if the API keys set up in the WooCommerce plugin and Maya Manager are the same.

  3. As needed, delete and/or regenerate new API keys as needed (maximum of 4, 2 sets of public and secret keys).

Review Webhook Setup

  1. Make sure that the Webhooks are enrolled under the merchant account enabled to use the Maya Checkout WooCommerce product/solution.

  2. Check if Webhooks setup in WooCommerce plugin and Maya Manager are the same.

⚠️ Webhook URLs/endpoints should be changed only in WooCommerce plugin dashboard; they are automatically synced in Maya Manager.

  1. Check if the Webhooks set up in Maya Manager are tested and are valid webhook endpoints.

✅ Use the Maya Manager Webhook Testing tool to check the registered webhook endpoints return 200 OK.

  1. Make sure that a specific set of Webhooks is used by only one (1) MID / merchant account.

Retrieving WooCommerce Logs

  1. Go to WordPress dashboard.

  2. Hover over the WooCommerce menu.

  3. Click Status submenu.

  4. Once the Status page has loaded, click on Logs tab.

  5. On the Logs tab, there should be a dropdown of log files (filename format: log-<date-of-transaction>.log).

If you're experiencing server errors or timeouts, check the Sandbox Health Page for real-time updates on service status. If an outage is indicated, rest assured that our team is already on it, working to restore services as soon as possible.

Possible Troubleshooting Use Cases

"There are no payment methods available." warning pops out

Click to see more

The plugin is incompatible with block-based checkout and may not be reflected as a payment method in WooCommerce.

  1. Use Classic Checkout
  2. Follow the steps to disable WooCommerce Blocks and enable Classic Checkout.
  3. If you need further help, check this.

Transaction does not exist in the WooCommerce plugin dashboard, but exists in Maya Manager

Click to see more
  1. Review our Basic Troubleshooting Steps.
  2. Do another transaction and take note of the order number (in WooCommerce dashboard) and reference number (in Maya Manager).
  3. If you need further help, check this.

Transaction status in WooCommerce plugin dashboard not in sync with Maya Manager (or status is not expected)

Click to see more

  1. Review our Basic Troubleshooting Steps.

  2. Do another transaction and take note of the order number (in WooCommerce dashboard) and reference number (in Maya Manager).

  3. Check Webhooks Setup. It is possible that webhooks are not being triggered or are not being received.

  4. Check if there are multiple sites that are using the same WooCommerce plugin and the same Maya Manager, see details.

  5. Check logs if relevant webhooks are sent (Maya Manager logs) and received (WooCommerce plugin logs).

  6. Retrigger Webhook in Maya Manager.

  7. Check Auth and Capture setup in both WooCommerce plugin and Maya Manager (with the help of your Maya Relationship Manager or the Maya Business Support ([email protected])), they should be aligned.

  8. Confirm if merchant setup is straight payments / automatic capture (and not manual capture).

⚠️ If merchant setup is manual capture, then they should capture first.

  1. If the status is PROCESSING in the WooCommerce plugin dashboard, it should be manually updated to COMPLETED.
  2. Do another transaction and check if there is still an error / if something still does not work.
  3. If you need further help, check this.

Webhook notifications not being triggered or not being received

Click to see more

  1. Review our Basic Troubleshooting Steps.

  2. Do another transaction and take note of the order number (in WooCommerce dashboard) and reference number (in Maya Manager).

  3. Check Webhooks Setup.

  4. Check logs if relevant webhooks are sent (Maya Manager logs) and received (WooCommerce plugin logs).

  5. Retrigger Webhook in Maya Manager.

  6. Check network security setup of the merchant site, turn-off firewall, and contact the hosting provider (troubleshoot for possible hosting issues).

  7. Do another transaction and check if there is still an error / if something still does not work.

  8. If you need further help, check this.

Webhooks in the WooCommerce plugin are not syncing to Maya Manager

Click to see more

  1. Review our Basic Troubleshooting Steps.

  2. Do another transaction and take note of the order number (in WooCommerce dashboard) and reference number (in Maya Manager).

  3. Check Webhooks Setup.

  4. Re-”Save” the webhook settings page (Payments) in the WooCommerce plugin dashboard.

  5. Check if there are multiple sites that are using the same WooCommerce plugin and the same Maya Manager, see details.

  6. Retrigger Webhook in Maya Manager.

  7. Do another transaction and check if there is still an error / if something still does not work.

  8. If you need further help, check this.

Capture button not showing in WooCommerce plugin dashboard

Click to see more

  1. Review our Basic Troubleshooting Steps.

  2. Do another transaction and take note of the order number (in WooCommerce dashboard) and reference number (in Maya Manager).

  3. Check Auth and Capture setup in both WooCommerce plugin and Maya Manager (with the help of your Maya Relationship Manager or the Maya Business Support ([email protected])), they should be aligned.

  4. Confirm if merchant setup is manual capture (and not straight payments / automatic capture).

⚠️ If merchant setup is manual capture, then they should capture first.

  1. Check if the full transaction amount has been captured. If only the partial amount has been captured, the transaction will still be PENDING (and not yet PROCESSING).
  2. Check with your Maya Relationship Manager if there is a backend merchant configuration i.e., special filtering of payload fields/details (that should only be used for Direct Checkout merchants), as this will limit sending of certain details from Maya Manager to WooCommerce plugin (including canCapture boolean field), and will affect display (or non-display) of the Capture button.
  3. Do another transaction and check if there is still an error / if something still does not work.
  4. If you need further help, check this.

Payment Status became Cancelled after Capturing (after being Pending for a long time)

Click to see more

  1. Review our Basic Troubleshooting Steps.

  2. Do another transaction and take note of the order number (in WooCommerce dashboard) and reference number (in Maya Manager).

  3. Check Webhooks Setup.

  4. Check Auth and Capture setup in both WooCommerce plugin and Maya Manager (with the help of your Maya Relationship Manager or the Maya Business Support ([email protected])), they should be aligned.

  5. Confirm if merchant setup is manual capture (and not straight payments / automatic capture).

⚠️ If merchant setup is manual capture, then they should capture first.

  1. Check if the full transaction amount has been captured. If only the partial amount has been captured, the transaction will still be PENDING (and not yet PROCESSING).
  2. Check if there are multiple sites that are using the same WooCommerce plugin and the same Maya Manager, see details.
  3. Ensure that there is a hold stock (minutes) configuration in WooCommerce>Inventory in the WooCommerce plugin dashboard. After the time setting in this field, all pending orders are cancelled, and the capture button will no longer appear.
  4. If the status is PROCESSING in the WooCommerce plugin dashboard, it should be manually updated to COMPLETED.
  5. Check logs if relevant webhooks are sent (Maya Manager logs) and received (WooCommerce plugin logs).
  6. Retrigger Webhook in Maya Manager.
  7. Do another transaction and check if there is still an error / if something still does not work.
  8. If you need further help, check this.

Encountering “Error Processing Checkout,” or “Payment Failed,” or “Invalid Request”

Click to see more

  1. Review our Basic Troubleshooting Steps.

  2. Do another transaction and take note of the order number (in WooCommerce dashboard) and reference number (in Maya Manager).

  3. Check WooCommerce plugin logs, this could be related to merchant onboarding setup, fraudulent transaction, currency used, cards used, or API keys used.

  4. Let your support or Maya Relationship Manager know which payment method you are using in the transaction. It is possible that there was an issue with its setup.

  5. Make sure you are only using one (1) of the following: Maya Manager 1.0 or Maya Business Manager. Otherwise, get in touch with your Maya Relationship Manager or the Maya Business Support ([email protected]).

  6. Do another transaction and check if there is still an error / if something still does not work.

  7. If you need further help, check this.

Error encountered during refund using the WooCommerce dashboard

Click to see more

  1. Review our Basic Troubleshooting Steps.

  2. Do another transaction and take note of the order number (in WooCommerce dashboard) and reference number (in Maya Manager).

  3. Let your support or Maya Relationship Manager know which payment method you are using in the transaction. It is possible that there was an issue with its setup.

  4. Check Maya Manager logs to see the actual error, i.e., if receiptNumber and requestReferenceNumber exist in the transaction refund details.

  5. Retry refund via WooCommerce dashboard.

  6. If a refund cannot be done anymore via the WooCommerce dashboard, this is due for manual refund by Maya’s Operations team.

  7. Do another transaction and check if there is still an error / if something still does not work.

  8. If you need further help, check this.

Encountering system errors/exceptions in the WooCommerce plugin dashboard

Click to see more

  1. Review our Basic Troubleshooting Steps.

  2. Do another transaction and take note of the order number (in WooCommerce dashboard) and reference number (in Maya Manager).

  3. Check WooCommerce plugin logs, and look for the actual error or exception logged.

  4. Check if there is another Maya WooCommerce plugin installed in the WordPress dashboard. Please use the most recent one, and deactivate/remove the old one/s.

  5. Check network security setup of the merchant site, turn-off firewall, and contact the hosting provider (troubleshoot for possible hosting issues).

  6. Check other installed plugins of the merchant site/WordPress dashboard (troubleshoot for possible compatibility issues).

  7. Do another transaction and check if there is still an error / if something still does not work.

  8. If you need further help, check this.

Not redirecting to Maya’s payment page

Click to see more

  1. Review our Basic Troubleshooting Steps.

  2. Do another transaction and take note of the order number (in WooCommerce dashboard) and reference number (in Maya Manager).

  3. Check WooCommerce plugin logs, this could be related to merchant onboarding setup, fraudulent transaction, currency used, cards used, or API keys used.

  4. Do another transaction and check if there is still an error / if something still does not work.

  5. If you need further help, check this.

Maya payment option does not appear on the website

Click to see more

  1. Review our Basic Troubleshooting Steps.

  2. Do another transaction and take note of the order number (in WooCommerce dashboard) and reference number (in Maya Manager).

  3. Check if Maya Payment Gateway is enabled in the WooCommerce dashboard.

ℹ️ As needed, disable/enable Maya Gateway in WooCommerce plugin.

  1. Check the customized backend code of the WooCommerce plugin, if there is hardcoded logic that allows or prevents certain payment options.
  2. Do another transaction and check if there is still an error / if something still does not work.
  3. If you need further help, check this.

No logs exist in the WooCommerce plugin

Click to see more

  1. Review our Basic Troubleshooting Steps.

  2. Do another transaction and take note of the order number (in WooCommerce dashboard) and reference number (in Maya Manager).

  3. Enable Sandbox Mode in the WooCommerce dashboard.

  4. Do another transaction and check if there is still an error / if something still does not work.

  5. If you need further help, check this.

If multiple sites are using the same WooCommerce plugin and/or Maya Manager

  1. Make sure only one (1) site or environment is active at a time (SandBox or Production) that is using the WooCommerce plugin and Maya Manager. It is possible that multiple plugin instances are the reason why the order statuses are not aligned or the webhook notifications are not triggered.

  2. Make sure you are only using one (1) of the following: Maya Manager 1.0 or Maya Business Manager. Otherwise, get in touch with your Maya Relationship Manager or the Maya Business Support ([email protected]).

If you need further help

  1. For Production concerns, please contact [email protected] or explore Maya Business Help Desk.
  2. For Sandbox concerns, create ASKMAYADEV ticket in Maya Developer Hub Service Desk .

ℹ️ See our ASKMAYADEV filing guide here.

  1. Uninstall/Install Maya WooCommerce plugin in WordPress.
  2. Disable other installed plugins in WordPress.
  3. Set up a Sandbox environment or a Production “Test” account. Please contact your Maya Relationship Manager.

When filing for ASKMAYADEV

  1. Make sure you are enrolled in the Maya Developer Hub Service Desk . Otherwise, please contact [email protected].

  2. Share the request payload and reference number (in Maya Manager) or the order number (in WooCommerce dashboard).

  3. Share the response payload and result/response code.

  4. Share a screen recording of transaction/s.

  5. Share the screenshots of Maya Manager transaction/s (list, status, and details) under the merchant account enabled to use WooCommerce.

  6. Share the screenshots of WooCommerce plugin order/s (list, status, and details).

  7. Share the WooCommerce plugin logs and check for errors (i.e., Currency issues, Fraud issues, Card issues).

Updated 12 days ago