Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt

Use this file to discover all available pages before exploring further.

Webhooks allow you to receive notifications of events that occurred on the platform. These notifications are delivered to an HTTPS endpoint of your choice.

​
Setup

Multiple webhook URLs per instance are supported. Webhooks can be configured by administrators by heading to Settings -> Manage Integrations -> Webhook subscriptions. For each subscription, it’s possible to listen to the events for all merchant accounts in an instance, or to the events for one merchant account.

​
Webhook delivery behavior

  1. Multiple subscriptions
    If you configure multiple subscriptions pointing to different URLs, each subscription receives its own webhook deliveries.
  2. Retries are subscription-specific
    If a webhook delivery fails, it is only retried for the subscription that encountered the failure, even if other subscriptions (pointing to the same or different URLs) succeed.

​
Supported features

  • Multiple webhook subscriptions per merchant account
  • Merchant account and instance-level webhook subscriptions
  • Detailed payloads for transactions, payment methods, buyers, billing details, and most other transaction related events.
  • Over 20 different webhook events.
  • Basic authentication credentials (username/password)
  • OAuth authentication (password and credentials grant)
  • Automatic retries of undelivered events
  • Webhook signatures to verify authenticity.

​
Next steps