Skip to main content
The coupon usage object records an individual instance of a coupon being applied to an invoice. It tracks the discount amount applied and links back to both the coupon and the invoice where the discount was used.
​
couponUsageId
string
The coupon usage unique identifier (UUIDv7).
​
couponId
string
The coupon ID associated with this usage.
​
invoiceId
string
The invoice ID associated with this usage.
​
organizationId
string
The organization ID that redeemed the coupon.
​
externalRef
string
The external reference for this usage.
​
amount
integer
The discount amount applied in cents.
​
status
string
The coupon usage status.
​
createdAt
string
Timestamp de criacao (ISO 8601).
​
updatedAt
string
Timestamp da ultima atualizacao (ISO 8601).
{
  "couponUsageId": "019525fe-6d58-7ed8-d0fc-8a0b2c4e6f8c",
  "couponId": "019525fd-d3a4-7baf-a7c3-9d1e3f5b7c9f",
  "invoiceId": "019525fd-c290-7a9e-f6b2-8c0d2e4a6b8e",
  "organizationId": "019525fd-4c38-7e30-a5c1-b6e3f4d8a9c2",
  "externalRef": "di_stripe_abc",
  "amount": 500,
  "status": "APPLIED",
  "createdAt": "2026-03-01T00:00:00.000Z",
  "updatedAt": "2026-03-01T00:00:00.000Z"
}