Skip to main content
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.
Example Payload
{
  "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.