lightning-delinvoice – Command for removing an invoice¶
delinvoice label status
The delinvoice RPC command removes an invoice with status as given in listinvoices.
The caller should be particularly aware of the error case caused by the status changing just before this command is invoked!
On success, an invoice description will be returned as per lightning-listinvoice(7).
The following errors may be reported:
- -1: Database error.
- 905: An invoice with that label does not exist.
- 906: The invoice status does not match the parameter. An error object will be returned as error data, containing current_status and expected_status fields. This is most likely due to the status of the invoice changing just before this command is invoked.
lightning-listinvoice(7), lightning-waitinvoice(7), lightning-invoice(7), lightning-delexpiredinvoice(7), lightning-autocleaninvoice(7)