Webhook Retry Logic

What is PayMongo's webhook retry logic?

Overview

PayMongo will retry delivering your webhook up to 12 times until it receives a successful response (HTTP 200 or any 2xx status) from your server.

Retry intervals follow an exponential backoff, with the full cycle lasting up to 136.5 minutes.

If three consecutive events each exhaust all 12 retries without success, your webhook will be disabled and must be manually re-enabled.

📘

Note

Merchants should implement a rollback mechanism to handle cases when their webhook URL or server is unavailable. PayMongo does not re-send missed webhook events, so it's crucial to design your system to handle interruptions and process events once your webhook URL is back online.

As a rollback mechanism, we suggest retrieving a payment intent by ID to check the status of a transaction.