Number of webhook attempts

General
1

How many webhook attempts will maya send to our endpoint?

2

Maya will attempt to send webhooks up to four times if the endpoint does not return a 2xx response. The attempts will be made immediately after the event is triggered, 5 minutes after the first failure, 15 minutes after the second failure, and 45 minutes after the third failure.

For Sandbox concerns and other technical implementation inquiries, please get in touch with us via:

  • Sandbox Health Page: Check real-time service status updates.
  • Maya Developer Hub Service Desk: File
    a ticket in Sandbox.

To Know More:

We value your input and would love to hear your insights. Please submit you feedback here.

3

Hi @kent,

To add with the AI’s response, you may also refer to this documentation on how to configure and manage webhooks: Managing Webhooks .

Let us know if this helps. Thanks!

4

Based on this documentation, this would mean that there should only be up to four attempts to deliver the webhooks.

Why would a webhook server receive up to five attempts?

5

Hello @kent,

If the webhook server is receiving more than four attempts, this may be due to:

  • Multiple status changes for the same payment, where each status transition triggers a new webhook event
  • The webhook event may actually correspond to a different transaction, not a retry of the same one. Be sure to verify the paymentId and payment status in the payload

Because webhook events can be delivered more than once under these conditions, we strongly recommend making your webhook handler idempotent and validating events using the payment ID and status before processing.

If you can share the relevant webhook logs (timestamps, payment IDs, event types, and HTTP response codes), we’d be happy to help you analyze what’s happening.

Received Multiple Webhooks