# Invoice payment refunded

Webhook sent when an invoice payment is refunded.

Endpoint: POST InvoicePaymentRefunded
Version: 2.0.0
Security: signatureAuth

## Request fields (application/json):

  - `event_id` (string, required)
    Unique event identifier.
    Example: "a7b8c9d0-e1f2-3456-abcd-567890123456"

  - `event_type` (string, required)
    Event type.
    Enum: "INVOICE_PAYMENT_REFUNDED"

  - `occurred_at` (string, required)
    Date and time when the event occurred.
    Example: "2026-04-03T16:23:00.000Z"

  - `data` (object, required)
    Event payload containing the affected invoice and payment records.

  - `data.invoice` (object, required)
    Represents invoice data.

  - `data.invoice.id` (string, required)
    Unique invoice identifier.
    Example: "inv_01KPWT0K1PQWEYYRT7J1H3NC85"

  - `data.invoice.created_at` (string, required)
    Date and time when the invoice was created.
    Example: "2025-12-24T11:45:00.000000Z"

  - `data.invoice.updated_at` (string, required)
    Date and time when the invoice was updated.
    Example: "2025-12-24T11:47:00.000000Z"

  - `data.invoice.status` (string, required)
    Current invoice status.
    Enum: "DRAFT", "OPEN", "PAID", "VOIDED"

  - `data.invoice.total_amount` (integer, required)
    Total invoice amount in minor units.
    Example: 1000

  - `data.invoice.currency` (string, required)
    Three-letter ISO-4217 currency code.
    Example: "USD"

  - `data.invoice.line_items` (array, required)
    Line items applied to the invoice.
    Example: [{"product_price_id":"e6f26db1-f633-4723-ab08-50ddee7bc648","description":"Great product","amount":990,"currency":"USD","amount_details":{"subtotal":1000,"discount":100,"taxable":900,"tax":90},"quantity":1,"tax":{"category_id":"taxc_01JJVD830C789HBQVTVCWJ6AK2","mode":"EXCLUSIVE","rate":10}}]

  - `data.invoice.line_items.product_price_id` (string)
    Identifier of the associated product price.
    Example: "e6f26db1-f633-4723-ab08-50ddee7bc648"

  - `data.invoice.line_items.description` (string)
    Line item description.
    Example: "Great product"

  - `data.invoice.line_items.amount` (integer, required)
    Line item amount in minor units.
    Example: 990

  - `data.invoice.line_items.currency` (string, required)
    Three-letter ISO-4217 currency code.
    Example: "USD"

  - `data.invoice.line_items.amount_details` (object, required)
    Represents invoice amount details.
    Example: {"subtotal":1000,"discount":100,"taxable":900,"tax":90}

  - `data.invoice.line_items.amount_details.subtotal` (integer, required)
    Subtotal amount in minor units before discounts and taxes.
    Example: 1000

  - `data.invoice.line_items.amount_details.discount` (integer, required)
    Discount amount in minor units.
    Example: 100

  - `data.invoice.line_items.amount_details.taxable` (integer)
    Taxable amount in minor units.
    Example: 900

  - `data.invoice.line_items.amount_details.tax` (integer)
    Tax amount in minor units.
    Example: 90

  - `data.invoice.line_items.quantity` (integer, required)
    Number of product units.
    Example: 1

  - `data.invoice.line_items.tax` (object)
    Tax details for the line item.
    Example: {"category_id":"taxc_01JJVD830C789HBQVTVCWJ6AK2","mode":"EXCLUSIVE","rate":10}

  - `data.invoice.line_items.tax.category_id` (string)
    Identifier of the tax category.
    Example: "taxc_01JJVD830C789HBQVTVCWJ6AK2"

  - `data.invoice.line_items.tax.mode` (string)
    Tax calculation mode.
    Enum: "EXCLUSIVE", "INCLUSIVE"

  - `data.invoice.line_items.tax.rate` (number)
    Tax rate as a percentage.
    Example: 10

  - `data.invoice.customer` (object, required)
    Represents customer snapshot details for invoice.

  - `data.invoice.customer.id` (string, required)
    Unique customer identifier.
    Example: "cust_01KMG2ABYPF6XS5DMJQ817C429"

  - `data.invoice.customer.first_name` (string)
    Customer first name.
    Example: "John"

  - `data.invoice.customer.last_name` (string)
    Customer last name.
    Example: "Doe"

  - `data.invoice.customer.email` (string)
    Customer email.
    Example: "customer@example.com"

  - `data.invoice.customer.phone` (string)
    Customer phone number.
    Example: "+1234567890"

  - `data.invoice.customer.address` (object)
    Customer address.

  - `data.invoice.customer.address.city` (string)
    City name.
    Example: "Anytown"

  - `data.invoice.customer.address.country` (string)
    Country according to the ISO-3166 alpha-3 country code.
    Example: "USA"

  - `data.invoice.customer.address.line1` (string)
    Address line 1.
    Example: "123 Main St"

  - `data.invoice.customer.address.line2` (string)
    Address line 2.
    Example: "Suite 456"

  - `data.invoice.customer.address.state` (string)
    State or province.
    Example: "CA"

  - `data.invoice.customer.address.postal_code` (string)
    Postal or ZIP code.
    Example: "12345"

  - `data.invoice.customer.tax` (object, required)
    Provides customer tax information.

  - `data.invoice.customer.tax.taxability` (string, required)
    Indicates if the customer is subject to tax.
    Enum: "EXEMPT", "TAXABLE"

  - `data.invoice.due_at` (string)
    Date and time when the invoice is due.
    Example: "2026-01-24T11:45:00.000000Z"

  - `data.invoice.amount_details` (object, required)
    Represents invoice amount details.

  - `data.invoice.discounts` (array)
    Discounts applied to the invoice.
    Example: [{"coupon_id":"0291b87b-deac-4eb4-8732-2a70d247a171","coupon_code":"WINTER25"}]

  - `data.invoice.discounts.coupon_id` (string)
    Unique identifier of the associated coupon.
    Example: "0291b87b-deac-4eb4-8732-2a70d247a171"

  - `data.invoice.discounts.coupon_code` (string)
    Code of the associated coupon.
    Example: "WINTER25"

  - `data.invoice.notes` (string)
    Additional notes for the invoice.
    Example: "Base pack"

  - `data.invoice_payment` (object, required)
    Represents invoice payment data.

  - `data.invoice_payment.id` (string, required)
    Unique payment identifier.
    Example: "inp_01KQ7FFRGJ5X0CKSHZ0ZJRQ4VW"

  - `data.invoice_payment.invoice_id` (string, required)
    Associated invoice identifier.
    Example: "inv_01KPWT0K1PQWEYYRT7J1H3NC85"

  - `data.invoice_payment.status` (string, required)
    Current payment status.
    Enum: "OPEN", "PAID", "VOIDED"

  - `data.invoice_payment.amount` (integer, required)
    Payment amount in minor units.
    Example: 1000

  - `data.invoice_payment.currency` (string, required)
    Three-letter ISO-4217 currency code.
    Example: "USD"

  - `data.invoice_payment.created_at` (string, required)
    Date and time when the payment was created.
    Example: "2025-12-24T11:45:00.000000Z"

  - `data.invoice_payment.updated_at` (string, required)
    Date and time when the payment was updated.
    Example: "2025-12-24T11:47:00.000000Z"