Transfer Webhooks
When a transaction is successfully performed in VaultsPay, a webhook event is triggered and delivered to all active webhook subscriptions configured for the user (or their parent agent).
Event Overview
| Event Name | TRANSACTION_PERFORMED |
| Delivery Method | HTTP POST |
| Content-Type | application/json |
| Retry Policy | 3 attempts with exponential backoff |
Payload Structure
Successful Transaction
{
"transactionId": "3ac58f37-3cc3-49b3-b3dd-9f83e4263b13",
"amount": 1000.00,
"status": "SUCCESS",
"refId": "CH-998877"
}Reversed Transaction
{
"transactionId": "3ac58f37-3cc3-49b3-b3dd-9f83e4263b13",
"amount": 1000.00,
"status": "REVERSED",
"refId": "CH-998877"
}Field Definitions
| Field | Type | Description |
|---|---|---|
transactionId | UUID | Unique identifier of the transaction. |
amount | Decimal | Transaction amount in cents. |
status | Enum | Final transaction status — SUCCESS or REVERSED. |
refId | String | Channel reference ID provided in the original request. |