Webhook Testing

This page is for anyone building or checking a webhook integration — engineers wiring up an endpoint for the first time, QA verifying a release, or support staff confirming a merchant's setup actually receives events. It walks through the Test Events tab, the fastest way to confirm your endpoint is listening and behaving correctly before it has to handle a real payment, payout, or subscription event.

If you haven't created a webhook endpoint yet, start with Creating a Webhook Endpoint. If you want to review how endpoints are managed day to day, see Setup & Management.

Supported Events

Resource	Event
Checkout Sessions	checkout_session.payment.paid
Link	link.payment.paid
QRPh	qrph.expired
QR	qr.paid
	qr.expired
Source	source.chargeable
Account	account.identity_verification.passed
	account.identity_verification.failed
Linked Account Onboarding	merchant.activated
	merchant.declined
	consumer.activated
	consumer.declined
Capability Request	capability_request.submitted
	capability_request.under_review
	capability_request.pending_clarification
	capability_request.processing
	capability_request.completed
	capability_request.declined
	capability_request.cancelled
Payment	payment.failed
	payment.paid
	payment.refund.updated
	payment.refunded
Payout	payout.deposited
	payout.returned
Transfer	transfer.inward.successful
	transfer.inward.failed
	transfer.outward.successful
	transfer.outward.failed
	pesonet.inward.detected
Subscription	subscription.activated
	subscription.invoice.created
	subscription.invoice.finalized
	subscription.invoice.paid
	subscription.invoice.payment_failed
	subscription.past_due
	subscription.unpaid
	subscription.updated
Workflow	workflow.completed
	workflow.failed

Troubleshooting

I don't see a Test Events tab
This tab only shows while the Dashboard is in Test mode. Switch out of Live mode using the mode toggle, then open the webhook again.

My expected event does not show in the events dropdown
Only events assigned to the webhook are shown. To include an event in the test event dropdown, Update your webhook to allow that specific event in the Overview tab.

Sending fails right away, before it reaches my server.
This usually means the webhook itself isn't set up to receive it — double-check the endpoint URL under the Overview tab and confirm the webhook's status is Enabled.

I sent a test event but it never reached my server.
Check the Event Deliveries tab first — it shows whether PayMongo recorded the attempt and what your server returned. If the attempt shows as failed or is missing entirely, confirm your endpoint is publicly reachable over HTTPS, responds with a 2xx status, and isn't blocked by a firewall or IP allowlist.

My server rejected the test event's signature.
Test events are signed the same way live events are, using the endpoint's secret key and the Paymongo-Signature header — see Setup & Management for how to verify it. A rejected signature usually means your handler is comparing against the wrong secret or hashing the raw body incorrectly.