Skip to main content

List available event types

Retrieve the complete list of event types your subscriptions can listen to, along with human-readable descriptions.

Response

boolean
true when the request succeeded.
object[]
Array of event type descriptors.

Event type reference

Standardized events

These are the recommended event types for new integrations.

Legacy events

These event types are preserved for backward compatibility with existing integrations. New integrations should prefer the standardized events above.

Webhook payload structure

All events share the same top-level payload structure:
The data object contains fields specific to the event type. For transaction events, it contains the full transaction record. For wallet events, it contains wallet balance details. For customer events, it contains customer profile fields.

Example payloads


Signature verification

Every webhook request includes headers you should use to verify that the payload originated from TagPay and has not been tampered with.

Headers

Your private key is the same key used for API authentication. You can retrieve it from the TagPay dashboard under API Keys.

Verifying with Node.js

Use the x-webhook-signature header for new integrations. It combines the timestamp with the payload to prevent replay attacks.
verify-webhook.js

Verifying the legacy signature

If you are on the legacy callback URL system, verify using the x-glide-signature header and SHA-512:
verify-legacy-webhook.js
Always use crypto.timingSafeEqual when comparing signatures. Standard string equality (===) is vulnerable to timing attacks.

Retry policy

TagPay attempts delivery up to 3 times per event before marking the delivery as failed. After all attempts are exhausted, you can manually trigger another delivery using the replay endpoint.
Your endpoint must respond with a 2xx HTTP status code within 10 seconds for the delivery to be counted as successful. Responses that time out or return 3xx, 4xx, or 5xx status codes are treated as failures and trigger a retry.