Webhook event

`refund.created`

A Refund was created.

Payload schema

api_versionanyrequired
contextobject
Present only when source is api. Identifies the acting project and API key.
- developer_platform_api_key_idstring | null · uuid
- developer_platform_project_idstring | null · uuid
created_atstring · date-timerequired
An ISO 8601 timestamp in UTC, with a Z suffix. For example, 2026-07-01T09:00:00Z.
dataobjectrequired
- objectobjectrequired
  - amountintegerrequired
    The refunded amount in minor currency units.
  - created_atstring · date-timerequired
    An ISO 8601 timestamp in UTC, with a Z suffix. For example, 2026-07-01T09:00:00Z.
  - currencystring | nullrequired
    The ISO 4217 currency code.
  - errorstring | nullrequired
    The failure message when the Refund did not complete.
  - idstring · uuidrequired
    The resource's unique identifier, formatted as an RFC 4122 version 4 UUID.
  - invoice_idstring | null · uuidrequired
    The Invoice associated with the refunded Payment, when one is assigned.
  - linksobjectrequired
    URLs to related resources.
    - patientstring | null · urirequired
      The full URL of a related resource.
  - notesstring | nullrequired
    Internal notes recorded with the Refund.
  - objectanyrequired
    Discriminator value emitted at object.
  - patient_idstring | null · uuidrequired
    The Patient associated with the Refund.
  - payment_idstring | null · uuidrequired
    The Payment this Refund was issued against.
  - reasonstring | nullrequired
    The reason the Refund was issued.
    Allowed values: other | other_party_will_pay | overcharged | overpaid | service_not_delivered | null
  - refund_sourcestring | nullrequired
    How the Refund is paid.
    Allowed values: bank_account | deduction_from_balance | payment_account | null
  - statusstring | nullrequired
    The Refund's current status.
    Allowed values: canceled | failed | processing | requires_action | succeeded | null
  - succeeded_atstring | null · date-timerequired
    An ISO 8601 timestamp in UTC, with a Z suffix. For example, 2026-07-01T09:00:00Z.
  - updated_atstring · date-timerequired
    An ISO 8601 timestamp in UTC, with a Z suffix. For example, 2026-07-01T09:00:00Z.
developer_platform_project_idstring | null · uuidrequired
The project ID whose credential caused the change. Null for dashboard events.
idstringrequired
Event identifier prefixed with evt_.
livemodebooleanrequired
false for test-event deliveries.
objectanyrequired
sourcestringrequired
Origin of the change. api means a Developer Platform mutation; dashboard means a Carebit-initiated change.
Allowed values: api | dashboard
typeanyrequired

Example

{
  "id": "evt_00000000-0000-4000-8000-000000000012",
  "object": "event",
  "api_version": "v1",
  "created_at": "2026-01-01T09:00:00Z",
  "data":  … }
    "object":  … }
      "id": "00000000-0000-4000-8000-000000000025",
      "object": "refund",
      "amount": 25000,
      "created_at": "2026-01-01T09:00:00Z",
      "currency": "gbp",
      "error": null,
      "invoice_id": "00000000-0000-4000-8000-000000000027",
      "links":  … }
        "patient": "https://api.carebit.co/v1/patients/00000000-0000-4000-8000-000000000004"
      },
      "notes": "Refund for a canceled consultation.",
      "patient_id": "00000000-0000-4000-8000-000000000004",
      "payment_id": "00000000-0000-4000-8000-000000000026",
      "reason": "service_not_delivered",
      "refund_source": "payment_account",
      "status": "processing",
      "succeeded_at": null,
      "updated_at": "2026-01-01T09:00:00Z"
    }
  },
  "developer_platform_project_id": null,
  "livemode": false,
  "source": "dashboard",
  "type": "refund.created"
}

Prefer plain text? Append ?format=md or send Accept: text/markdown to receive this page as raw Markdown.