---
title: "An invoice was paid"
method: POST
path: "invoice.paid"
---

# An invoice was paid

`POST invoice.paid` (webhook)

An invoice's status became paid (marked paid in Dynt or matched to a payment). data.object is the invoice as GET /v1/invoices/{id} returns it.

## Headers

- `Dynt-Signature` string, required
- `Dynt-Event-Id` string, required
- `Dynt-Event-Type` 'invoice.paid', required

## Payload

- object
  - `id` string, required: Event id, evt_…; the same on every retry. Deduplicate on it.
  - `type` 'invoice.paid', required
  - `created_at` string, required: When the change happened (RFC 3339, UTC).
  - `api_version` 'v1', required
  - `data` object, required
    - `object` object, required: An invoice the organization issued (receivable).
      - `id` string, required
      - `number` string, required: Dynt's sequence number for the document.
      - `custom_id` string, nullable, required: The organization's own document number, when set.
      - `approval_status` string, required
      - `currency` string, required
      - `net_amount` string, required: Total before VAT.
      - `vat_amount` string, required: Decimal amount as a string with the currency's own decimals (ISO 4217: 2 for EUR, 0 for JPY, 3 for BHD, 4 for CLF), e.g. "1234.50"; eur_amount always has 2.
      - `total_amount` string, required: Total including VAT.
      - `eur_amount` string, nullable, required: Decimal amount as a string with the currency's own decimals (ISO 4217: 2 for EUR, 0 for JPY, 3 for BHD, 4 for CLF), e.g. "1234.50"; eur_amount always has 2.
      - `fx_rate` string, nullable, required: The stored exchange rate used for eur_amount, as a decimal string; null when none is stored.
      - `issue_date` string, date-time, nullable, required: RFC 3339 date-time in UTC.
      - `due_date` string, date-time, required: RFC 3339 date-time in UTC.
      - `category` object, nullable, required
        - `id` string, required
        - `name` string, required
      - `purchase_order_reference` string, nullable, required
      - `created_at` string, date-time, required: RFC 3339 date-time in UTC.
      - `updated_at` string, date-time, required: RFC 3339 date-time in UTC.
      - `proofs` object[], required
        - `id` string, required
        - `filename` string, required
        - `content_type` string, required
        - `size_bytes` integer, nullable, required: File size in bytes; null when unknown.
        - `created_at` string, date-time, required: When the file was attached.
      - `status` 'draft' | 'sent' | 'paid' | 'cancelled' | 'overdue' | 'scheduled', required
      - `type_code` string, required: UNCL1001 document type: 380 invoice, 381 credit note.
      - `customer` object, nullable, required: The customer invoiced; null if the invoice names a customer outside the organization.
        - `id` string, required
        - `name` string, required
        - `tax_number` string, nullable, required
      - `buyer_reference` string, nullable, required
      - `original_invoice_id` string, nullable, required: For a credit note, the invoice it credits.
      - `sent_at` string, date-time, nullable, required: RFC 3339 date-time in UTC.

## Acknowledgement `2XX`

Received. Any other answer, or none within 10 seconds, is retried.

---

[API](https://skmtc.dev/dynt/apis/dynt-api.md) · [All operations](https://skmtc.dev/dynt/apis/dynt-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dynt/apis/dynt-api/revisions/35825587b87b?raw)