BYbyaccrue
Webhook Topics

Transaction Failed

Fired when a transaction fails. This event indicates that the transaction could not be processed successfully. The included payload contains event data with a fee object (fee type and amount in cents) and failureReason (TransactionFailureReason: e.g. Canceled, HardDecline, SoftDecline, Expired, InsufficientFunds, Reversed, Unknown).

postWebhooktransactionFailed

Payload

idstring uuid required

Unique identifier for the object.

type'WebhookEvent' required

Example payload

{
  "attributes": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "walletId": "123e4567-e89b-12d3-a456-426614174000"
  },
  "included": [
    {
      "attributes": {
        "transactionId": "123e4567-e89b-12d3-a456-426614174000",
        "walletId": "123e4567-e89b-12d3-a456-426614174000",
        "rewardIds": [],
        "fee": {
          "type": "JitFundingFee",
          "amount": 125
        },
        "failureReason": "SoftDecline"
      }
    }
  ]
}

Response

Return a 200 status to indicate that the data was received successfully

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.