{ "status": true, "message": "Available event types", "data": [ { "type": "transaction.success", "description": "Triggered when a transaction completes successfully" }, { "type": "transaction.failed", "description": "Triggered when a transaction fails" }, { "type": "transaction.pending", "description": "Triggered when a transaction is pending" }, { "type": "wallet.credit", "description": "Triggered when a wallet is credited" }, { "type": "wallet.debit", "description": "Triggered when a wallet is debited" }, { "type": "customer.created", "description": "Triggered when a new customer is created" }, { "type": "card.linked", "description": "Triggered when a card is linked to a wallet" }, { "type": "transfer.completed", "description": "Triggered when a transfer completes successfully" }, { "type": "transfer.failed", "description": "Triggered when a transfer fails" }, { "type": "*", "description": "Subscribe to ALL webhook events" } ]}
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.
{ "event": "test.webhook", "data": { "message": "This is a test webhook from TagPay", "timestamp": "2024-04-01T10:00:00.000Z", "subscriptionId": "sub_e5f6a7b8-c9d0-1234-efab-567890123456", "merchantId": "merch_001" }}
TagPay attempts delivery up to 3 times per event before marking the delivery as failed.
Attempt
Timing
1
Immediately after the event fires.
2
1 minute after the first failure.
3
5 minutes after the second failure.
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.
{ "status": true, "message": "Available event types", "data": [ { "type": "transaction.success", "description": "Triggered when a transaction completes successfully" }, { "type": "transaction.failed", "description": "Triggered when a transaction fails" }, { "type": "transaction.pending", "description": "Triggered when a transaction is pending" }, { "type": "wallet.credit", "description": "Triggered when a wallet is credited" }, { "type": "wallet.debit", "description": "Triggered when a wallet is debited" }, { "type": "customer.created", "description": "Triggered when a new customer is created" }, { "type": "card.linked", "description": "Triggered when a card is linked to a wallet" }, { "type": "transfer.completed", "description": "Triggered when a transfer completes successfully" }, { "type": "transfer.failed", "description": "Triggered when a transfer fails" }, { "type": "*", "description": "Subscribe to ALL webhook events" } ]}
Assistant
Responses are generated using AI and may contain mistakes.