mirrors/core-lightning
1
0
Fork 0
mirror of https://github.com/ElementsProject/lightning.git synced 2025-01-05 21:44:42 +01:00
Code Issues Projects Releases Wiki Activity
7435d50970
core-lightning/doc/lightning-delinvoice.7.md
ZmnSCPxj jxPCSnmZ e7d89cd7de lightningd/invoice.c: Improve programmatic error reporting for delinvoice. 
Changelog-Changed: JSON-RPC: `delinvoice` will now report specific error codes: 905 for failing to find the invoice, 906 for the invoice status not matching the parameter.
2020-07-31 23:57:32 +00:00

1.2 KiB
Raw Blame History

lightning-delinvoice -- Command for removing an invoice

SYNOPSIS

delinvoice label status

DESCRIPTION

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!

RETURN VALUE

On success, an invoice description will be returned as per lightning-listinvoice(7).

ERRORS

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.

AUTHOR

Rusty Russell <rusty@rustcorp.com.au> is mainly responsible.

SEE ALSO

lightning-listinvoice(7), lightning-waitinvoice(7), lightning-invoice(7), lightning-delexpiredinvoice(7), lightning-autocleaninvoice(7)

RESOURCES

Main web site: https://github.com/ElementsProject/lightning