> ## Documentation Index
> Fetch the complete documentation index at: https://docs.delegare.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Onchain Webhooks

> Handle incoming webhooks for crypto settlement on Base.

If you support dual-rail settlement or exclusively accept crypto payments on the Base L2 network, Delegare listens to the blockchain for successful transactions and forwards the events to your webhook endpoint.

### Available Events

* `payment.succeeded`: Fired when a charge successfully settles on the Base L2 rail.
* `payment.failed`: Fired when an onchain transaction fails (e.g., reverted transaction, out of gas).
* `delegate.created`: Fired when a user successfully connects a wallet and completes the setup session.
* `delegate.revoked`: Fired when a user revokes their onchain delegate token via the Delegare dashboard or a smart contract call.

### Webhook Format

Similar to fiat webhooks, onchain webhooks include a JSON payload and an `X-Delegare-Signature` header.

```json Example Payload theme={null}
{
  "id": "evt_02H...",
  "type": "payment.succeeded",
  "data": {
    "transactionId": "txn_987654321",
    "amountCents": 500,
    "rail": "base",
    "status": "succeeded",
    "txHash": "0x123abc456def789..."
  },
  "created_at": "2024-03-27T10:05:00Z"
}
```

### Differences from Stripe

Onchain webhooks may contain additional metadata, such as the `txHash`, allowing you to provide a link to a block explorer like BaseScan for your users.