---
url: https://docs.youcan.shop/store-admin/entities/invoice.md
---
# Invoice entity

The Invoice entity at YouCan.

| Attribute Name | Type | Description |
| --- | --- | --- |
| id | string | Identifier (UUID) |
| amount | float | Total invoice amount |
| paid\_amount | float | Amount already paid |
| status | string | Translated status label (e.g. `"Paid"`, `"Pending"`) — do not use for logic as it varies by locale |
| payment\_gateway | string, null | Payment gateway used (e.g. `"Stripe"`), null if not applicable |
| description | string | Dynamically generated description based on invoice type (subscription, domain, credit, app charge, etc.) |
| created\_at | string | Creation date (ISO 8601, store timezone) |
| updated\_at | string | Last update date (ISO 8601, store timezone) |
| paid\_at | string, null | Payment date (ISO 8601, store timezone), null if unpaid |
| deleted\_at | string, null | Deletion date (ISO 8601), null if not deleted |
| links.pdf | string | URL to download the invoice as a PDF |