Using Webhooks with Qualpay Plugin for WooCommerce

Use Qualpay’s webhooks to keep your WooCommerce orders up-to-date with the latest transaction statuses. You will need to retrieve your webhook secret from the Qualpay Merchant Manager and paste it into your WooCommerce plugin configuration page for the Qualpay plugin.

To add webhooks to either your sandbox or production Qualpay account:

1. Log into your WooCommerce administration site.
2. Go to the WooCommerce Plugins page.
3. Click Settings under the Qualpay plugin.
   1. A unique webhook notification URL will be generated and displayed.
4. Copy this URL to enter into the Notification URL field within the Qualpay Merchant Manager.
5. Go to Qualpay Merchant Manager to create and configure your webhooks.
6. Ensure that the specific Qualpay webhook events listed below are enabled to use with the WooCommerce plugin:

• Transaction_status_updated: this webhook will keep the order status up-to-date with information on settled transactions from Qualpay. 
• Qp_manager_void_success: If you void a transaction in Qualpay Manager, your WooCommerce order status will change to Void.
• Qp_manager_refund_success: If you refund a transaction in Qualpay Manager, your WooCommerce order status will change to Refunded or Partial Refund. 
• Qp_manager_capture_success: If you capture a transaction in Qualpay Manager, your WooCommerce order status will change to Captured.
• If you are processing recurring payments, enable the Subscription_payment_success webhook. This webhook indicates that the recurring charge to the cardholder was successful, and your WooCommerce order status will change to Captured.

7. Go back to your WooCommerce administration site and paste the Qualpay Webhook key in the Webhook Secret field for the Qualpay plugin.

8. Click Save Changes.

Testing Your Qualpay Webhooks

Now that you have added webhooks to your Qualpay account, you can test the webhook event:

1. Process an order from the web store.
2. Log in to your sandbox or production Qualpay account (depending on which environment you are testing). 
3. Click Transactions. 
4. Locate the processed transaction. 
5. Issue a Void, Refund, or Capture this transaction by clicking on the Transaction Detail, then click one of the Action buttons on the right.

Once the transaction is voided, refunded, or captured, verify that the order status has been updated in WooCommerce:

1. Log in to your WordPress administration site.
2. Click Orders. 
3. Locate the updated order in the Qualpay Merchant Manager. 
4. Compare and verify that the status has been updated on the WooCommerce Orders page. 

Click here for information on reconciling WooCommerce Orders and Qualpay transactions.