PayPal Invoicing defines a set of statuses that represent an invoice’s lifecycle. Most invoices follow a simple flow: Draft → Due → Paid (or Cancelled). An invoice starts as a draft, is sent to request payment, and finishes as paid or canceled, depending on the result.Documentation Index
Fetch the complete documentation index at: https://docs.paypal.ai/llms.txt
Use this file to discover all available pages before exploring further.
Invoice statuses
The invoice status determines how the invoice should be interpreted and what actions are allowed at any given point.| UI status | API status | Description and possible actions | Next possible status |
|---|---|---|---|
| Draft | DRAFT | All invoices start in draft status. The invoice is created but not sent. It is fully editable and invisible to the payer. | Due, Scheduled, Overdue (after the due date), Marked as Paid, or Deleted |
| Due | SENT or UNPAID | The invoice is payable. - SENT: The invoice is sent to the customer’s registered email address through the invoicing UI. - UNPAID: The invoice is shared through a link or QR code. | Overdue (after the due date), Paid, Partially Paid, or Canceled |
| Overdue | SENT or UNPAID | The invoice is payable and past due. - SENT: The invoice is sent to the customer’s registered email address through the invoicing UI. - UNPAID: The invoice is shared through a link or QR code. | Paid, Partially Paid, or Canceled |
| Scheduled | SCHEDULED | The invoice is scheduled for a future send date. The invoice is fully editable and invisible to the payer. | Due (on the scheduled date), Overdue (after the due date), or Deleted |
| Partially Paid | PARTIALLY_PAID | Partially paid with an outstanding balance. | Paid when the remaining balance is collected |
| Paid | PAID or MARKED_AS_PAID | - PAID: The invoice is fully paid and settled, and is no longer payable. - MARKED_AS_PAID: The invoice is manually marked as paid to reflect an external payment for reconciliation. | Partially Refunded, Marked as Refunded or Refunded, if you issue a refund |
| Payment Pending | PAYMENT_PENDING | Payment is in progress but not yet completed. | Paid, Partially Paid |
| Canceled | CANCELLED or AUTO_CANCELLED | - CANCELLED: The invoice is canceled, no longer payable, and retained for audit and reference. - AUTO_CANCELLED: The invoice is automatically cancelled. | No further transitions allowed |
| Partially Refunded | PARTIALLY_REFUNDED | The invoice has been partially refunded, so some but not all of the original payment has been returned. | No further transitions allowed |
| Refunded | REFUNDED or MARKED_AS_REFUNDED | - REFUNDED: The invoice is fully refunded. - MARKED_AS_REFUNDED: The invoice is manually marked as refunded to show that the refund was handled outside PayPal and is used for manual reconciliation. | No further transitions allowed |