Use this guide when a payment succeeds in Orcuspay but your store, WHMCS invoice, or custom app does not update.

​
Common symptoms

  • Payment is successful in Orcuspay, but the order stays pending.
  • WHMCS invoice does not mark as paid.
  • WooCommerce order does not move to processing/completed.
  • Webhook endpoint shows failed attempts.
  • Signature or webhook secret validation fails.

​
Checklist

  1. Confirm the webhook endpoint URL is correct.
  2. Confirm the endpoint is publicly reachable over HTTPS.
  3. Confirm the selected event is checkout.session.complete.
  4. Confirm the webhook signing secret in Orcuspay matches the secret saved in your module.
  5. Confirm your server does not block Orcuspay webhook requests with a firewall, WAF, or maintenance mode.
  6. Confirm test mode and live mode are not mixed.
  7. Confirm the order or invoice reference sent to Orcuspay matches the local order or invoice.

​
Test with a fresh endpoint

  • Go to Developers > Webhooks.
  • Add a new endpoint from your module configuration page.
  • Select checkout.session.complete.
  • Copy the new signing secret into your module.
  • Save the module settings.
  • Create a new test payment.

​
Module-specific notes

​
WooCommerce

  • The webhook URL should come from the Orcus WooCommerce payment settings.
  • Make sure pretty permalinks are working.
  • Clear cache/security plugins if webhook requests are blocked.

​
WHMCS

  • The callback file must be uploaded to the correct modules/gateways/callback path.
  • The webhook secret in WHMCS must match the Orcuspay endpoint signing secret.
  • Test with a new unpaid invoice instead of reusing an already-paid invoice.

​
Still failing?

Send support:
  • Orcuspay payment ID
  • Order or invoice ID
  • Webhook endpoint URL
  • Webhook event status
  • Module name and version
  • Test mode or live mode