Skip to main content
Set callback_url when you create a payment intent, and that payment’s events (charge.succeeded, charge.failed and the rest) go to that URL instead of your account webhook. This is useful when one Modem Pay account serves several systems, like a marketplace where each shop has its own server.
The body is the same as a webhook: { "event": "...", "payload": { ... } }. Retries work the same way too: up to 3 more tries, 10 minutes apart.

Verify a callback

Callbacks are signed differently from webhooks. There’s no webhook secret here. Instead, the signing key is the SHA-256 hash of your secret API key, as lowercase hex.
Callbacks are signed with your newest active secret key on that account. After you roll a key, callbacks are signed with the new one. If you keep several keys, use x-modem-signature-key to pick the right one.
Use an HTTPS URL. As with webhooks, use the raw request body, and reply 200 quickly.