Skip to main content
The voucher object represents a credit balance assigned to a specific organization. Unlike coupons (which are percentage or fixed discounts), vouchers provide a monetary credit that is drawn down as the organization incurs charges.
​
voucherId
string
O identificador unico do voucher (UUIDv7).
​
organizationId
string
O ID da organizacao.
​
externalRef
string
The external reference for the voucher.
​
name
string
The voucher display name.
​
amount
integer
The voucher total amount in cents.
​
currency
string
O codigo da moeda (ex: BRL, USD).
​
effectiveAt
string|null
Timestamp when the voucher becomes effective (ISO 8601).
​
expiresAt
string|null
Timestamp when the voucher expires (ISO 8601).
​
amountRedeemed
integer
The amount already redeemed in cents.
​
status
string
O status do voucher. One of: PENDING, ACTIVE, DEPLETED, EXPIRED.
​
createdBy
string
The actor who created the voucher.
​
createdAt
string
Timestamp de criacao (ISO 8601).
​
updatedBy
string
The actor who last updated the voucher.
​
updatedAt
string
Timestamp da ultima atualizacao (ISO 8601).
​
deletedBy
string
The actor who deleted the voucher.
​
deletedAt
string
Deletion timestamp (ISO 8601).
{
  "voucherId": "019525fd-e4b8-7cb0-b8d4-0e2f4a6c8d0a",
  "organizationId": "019525fd-4c38-7e30-a5c1-b6e3f4d8a9c2",
  "externalRef": "vch_1Oy2pL2eZvKYlo2C0vIqMZ8y",
  "name": "Onboarding Credit",
  "amount": 50000,
  "currency": "BRL",
  "effectiveAt": "2026-02-01T00:00:00.000Z",
  "expiresAt": "2026-08-01T00:00:00.000Z",
  "amountRedeemed": 12500,
  "status": "ACTIVE",
  "createdBy": "019525fd-56a8-7db4-8c3e-2a1b4d6f8e0c",
  "createdAt": "2026-01-20T10:00:00.000Z",
  "updatedBy": "019525fd-56a8-7db4-8c3e-2a1b4d6f8e0c",
  "updatedAt": "2026-03-10T09:30:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}