Invoice statuses

Invoices have several status and status_context options.
Status
Status context
Description
new
null
The invoice has been created and we are waiting for the payment
completed
null
The invoice amount has been credited to your account
unresolved
underpaid
The invoice has been underpaid and must be resolved
unresolved
overpaid
The invoice has been overpaid and must be resolved
unresolved
paid_late
The invoice has been paid after the validity time period and must be resolved
refunded
null
The full transaction amount has been refunded
cancelled
null
The invoice hasn't been paid or the broadcasted transaction hasn't been confirmed on the network within 14 days
Underpaid
paid_amount is less than pay_amount.
Callback event
Invoice status
Invoice status context
Description
transaction_created
new
null
A customer has just broadcasted their transaction on the network but paid_amount is less than pay_amount
transaction_confirmed
new
null
The transaction has been confirmed on the network
status_change
unresolved
underpaid
The invoice needs to be resolved
Overpaid
paid_amount is greater than pay_amount.
Callback event
Invoice status
Invoice status context
Description
transaction_created
new
null
A customer has just broadcasted their transaction on the network but  paid_amount is greater than pay_amount
transaction_confirmed
new
null
The transaction has been confirmed on the network
status_change
unresolved
overpaid
The invoice needs to be resolved
Paid late
The transaction has been broadcasted after the invoice validity period.
Callback event
Invoice status
Invoice status context
Description
transaction_created
new
null
A customer has broadcasted their transaction on the network after the  invoice validity period
transaction_confirmed
new
null
The transaction has been confirmed on the network
status_change
unresolved
paid_late
The invoice needs to be resolved

Invoice payment sequence

How to handle exceptions

Last updated -3

Status	Status context	Description
`new`	`null`	The invoice has been created and we are waiting for the payment
`completed`	`null`	The invoice amount has been credited to your account
`unresolved`	`underpaid`	The invoice has been underpaid and must be resolved
`unresolved`	`overpaid`	The invoice has been overpaid and must be resolved
`unresolved`	`paid_late`	The invoice has been paid after the validity time period and must be resolved
`refunded`	`null`	The full transaction amount has been refunded
`cancelled`	`null`	The invoice hasn't been paid or the broadcasted transaction hasn't been confirmed on the network within 14 days

Callback event	Invoice status	Invoice status context	Description
`transaction_created`	`new`	`null`	A customer has just broadcasted their transaction on the network but `paid_amount` is less than `pay_amount`
`transaction_confirmed`	`new`	`null`	The transaction has been confirmed on the network
`status_change`	`unresolved`	`underpaid`	The invoice needs to be resolved

Callback event	Invoice status	Invoice status context	Description
`transaction_created`	`new`	`null`	A customer has just broadcasted their transaction on the network but `paid_amount` is greater than `pay_amount`
`transaction_confirmed`	`new`	`null`	The transaction has been confirmed on the network
`status_change`	`unresolved`	`overpaid`	The invoice needs to be resolved

Callback event	Invoice status	Invoice status context	Description
`transaction_created`	`new`	`null`	A customer has broadcasted their transaction on the network after the invoice validity period
`transaction_confirmed`	`new`	`null`	The transaction has been confirmed on the network
`status_change`	`unresolved`	`paid_late`	The invoice needs to be resolved