Docs
Dashboard

Integrations / Developer

Webhooks

Live

HTTPS callbacks signed with HMAC-SHA256, retried with backoff for about a day and logged per attempt. Manage endpoints, view deliveries and retry under Developer > Webhooks.

Install

  • Developer > Webhooks (dashboard /developer/webhooks)
  • Webhooks reference: reference

Setup

  1. Add an endpoint (In the Gully Pay dashboard)
    • Add your HTTPS URL and the events you want. Copy the signing secret: it is shown once.
  2. Verify signatures (On your server)
    • Check X-GullyPay-Signature on the raw body and dedupe on X-GullyPay-Event-Id.

Scopes and events

  • Webhook events: checkout.session.completed, checkout.session.expired, checkout.session.payment_failed, payment.succeeded, payment.failed, payment.refunded, order.fulfilled, order.cancelled, x402.payment.received, payout.paid, payout.failed (see Webhooks)
  • API base URL: https://gullypay.xyz/api