Mandate revocation failed

Triggered when a wallet revocation fails. mandate.status becomes revocation_failed. The spending allowance was not removed, so the mandate remains usable if it was usable before the attempt (revokedAt stays unset). Inspect revocation.error for the reason, then retry with a new wallet revocation.

postWebhookacceptanceMandateRevocationFailed

Payload

eventIdstring uuid required

Unique identifier for this webhook event. Use this for idempotency.

timestampstring date-time required

When this event occurred (ISO 8601 format).

eventType'acceptance.mandate.revocation_failed' required

The type of webhook event.

Example payload

{
  "eventId": "723e4567-e89b-12d3-a456-426614174006",
  "timestamp": "2026-08-21T14:15:00Z",
  "eventType": "acceptance.mandate.revocation_failed",
  "data": {
    "mandate": {
      "mandateId": "mandate_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
      "asset": "usdc",
      "source": {
        "address": "0xAbC1234567890aBcDeF1234567890AbCdEf123456",
        "network": "base",
        "asset": "usdc"
      },
      "policy": {
        "maxPerAuthorization": "50.00",
        "maxPerPeriod": {
          "amount": "500.00",
          "period": "month"
        }
      },
      "status": "revocation_failed",
      "expiresAt": "2027-06-15T12:00:00.000Z",
      "revocationUrl": "https://payments.coinbase.com/mandates/mandate_82c879c1-84e1-44ed-a8c2-1ac239cf09ad/revoke",
      "approvedAt": "2025-06-15T12:05:00.000Z",
      "createdAt": "2025-06-15T12:00:00.000Z",
      "updatedAt": "2026-08-21T14:15:00.000Z"
    },
    "revocation": {
      "revocationId": "revocation_1a7f2b93-4c5d-4e6f-8a9b-0c1d2e3f4a5b",
      "mandateId": "mandate_82c879c1-84e1-44ed-a8c2-1ac239cf09ad",
      "status": "failed",
      "error": {
        "code": "transaction_reverted",
        "message": "The revocation transaction reverted on-chain.",
        "occurredAt": "2026-08-21T14:15:00.000Z"
      },
      "createdAt": "2026-08-21T14:10:00.000Z",
      "updatedAt": "2026-08-21T14:15:00.000Z"
    }
  }
}

Response

Webhook received and processed 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.