Callbacks
Callbacks and webhooks
Receive payment outcomes on your server.
Your merchant callback is a webhook: Vantra sends an HTTPS POST to an endpoint you register in the portal. This is separate from the bank-to-gateway callback and the cardholder's browser return URL.
Step 1
Register an enabled TEST payment webhook before changing payment status.
Step 2
Simulate a payment outcome in the portal.
Step 3
Vantra signs the event and POSTs it to your server.
Step 4
Your server verifies, durably records the event, and returns 2xx.
- Configuration: URL, environment, and signing secret.
- Handling and verification: exact signature and receiver pattern.
- Events and retries: payloads, duplicate delivery, and failure recovery.
Use the signed event format documented here for gateway payment transitions. An older unsigned worker also exists in the codebase; do not accept unsigned requests as a fallback for this integration.