Monitor the WooCommerce Webhooks

The Asaas Plugin uses Webhooks to keep WooCommerce orders synchronized with charge changes in Asaas.

Use this synchronization to update orders without periodic API queries.

How it works

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Charge is updated in Asaas"] --> B["Asaas sends the Webhook"]
B --> C["Plugin receives the event"]
C --> D["Update the order in WooCommerce"]

classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

class A inicio
class B,C validacao
class D sucesso

linkStyle default stroke:#94A3B8,stroke-width:2px

If an order is not updated after a change in the charge, check the Webhook queue first.

Check the queue status

Through the WooCommerce status

Go to:

WooCommerce > Status

Locate the Meio de Pagamentos Asaas section.

In this area you can check:

• the status of the connection with Asaas;
• the status of the Webhook queue;
• the Re-enable webhook queue option, when the queue is interrupted.

When synchronization is working, the connection and the queue will be displayed as active.

Through the payment method

The status can also be checked in the Webhook section of the settings of any Asaas Plugin payment method.

In this setting, also provide an email address to receive alerts related to queue interruption.

Recover an interrupted queue

When synchronization is interrupted:

• the queue status will be displayed as interrupted;
• the Re-enable webhook queue option will become available;
• a warning will be displayed on the WooCommerce Orders screen;
• the Webhook section of the payment methods will also indicate the interruption.

Before reactivating the queue:

1. Go to the Webhook Logs.
2. Identify the HTTP code, the error message, and the delivery attempts.
3. Fix the cause of the failure.
4. Go back to WooCommerce and click Re-enable webhook queue.
5. Confirm that the queue is back to the active state.

If the queue remains interrupted, review the logs again and see Common errors.

Expected result

After the fix and reactivation:

• the queue should return to the active state;
• the Re-enable webhook queue option should no longer be displayed;
• new events should once again update orders in WooCommerce.

Next steps

• See the Webhook Logs
• See the common WooCommerce errors
• Review the initial settings
• See the WooCommerce FAQ