Skip to main content
The voucher usage object records an individual instance of a voucher credit being applied to an invoice. It tracks the credit amount consumed and links back to both the voucher and the invoice.
​
voucherUsageId
string
The voucher usage unique identifier (UUIDv7).
​
voucherId
string
The voucher ID associated with this usage.
​
invoiceId
string
The invoice ID associated with this usage.
​
organizationId
string
The organization ID that used the voucher.
​
externalRef
string
The external reference for this usage.
​
amount
integer
The discount amount applied in cents.
​
status
string
The voucher usage status.
​
createdAt
string
Timestamp de criacao (ISO 8601).
​
updatedAt
string
Timestamp da ultima atualizacao (ISO 8601).
{
  "voucherUsageId": "019525fe-7e6c-7fe9-e1ad-9b1c3d5f7a9d",
  "voucherId": "019525fd-e4b8-7cb0-b8d4-0e2f4a6c8d0a",
  "invoiceId": "019525fd-c290-7a9e-f6b2-8c0d2e4a6b8e",
  "organizationId": "019525fd-4c38-7e30-a5c1-b6e3f4d8a9c2",
  "externalRef": "di_stripe_abc",
  "amount": 2500,
  "status": "APPLIED",
  "createdAt": "2026-03-01T00:00:00.000Z",
  "updatedAt": "2026-03-01T00:00:00.000Z"
}