disableinvoicerequest -- Command for removing an invoice request

SYNOPSIS

disableinvoicerequest invreq_id

DESCRIPTION

Command added in v22.11.

The disableinvoicerequest RPC command disables an invoice_request, so that no further invoices will be accepted (and thus, no further payments made)..

We currently don't support deletion of invoice_requests, so they are not forgotten entirely (there may be payments which refer to this invoice_request).

invreq_id (string): A specific invoice can be disabled by providing the invreq_id, which is presented by lightning-invoicerequest(7).

RETURN VALUE

Note: the returned object is the same format as listinvoicerequests.
On success, an object is returned, containing:

invreq_id (hash): The SHA256 hash of all invoice_request fields less than 160.
active (boolean) (always false): Whether the invoice_request is currently active.
single_use (boolean): Whether the invoice_request will become inactive after we pay an invoice for it.
bolt12 (string): The bolt12 string starting with lnr.
used (boolean): Whether the invoice_request has already been used.
label (string, optional): The label provided when creating the invoice_request.

AUTHOR

Rusty Russell [email protected] is mainly responsible.

RESOURCES

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

EXAMPLES

Example 1:

Request:

lightning-cli disableinvoicerequest -k "invreq_id"="bdbaa2fa505fef38702e3c239241cc4ecbca06be87e6034ef9dd849f0a32646c"

{
  "id": "example:disableinvoicerequest#1",
  "method": "disableinvoicerequest",
  "params": {
    "invreq_id": "bdbaa2fa505fef38702e3c239241cc4ecbca06be87e6034ef9dd849f0a32646c"
  }
}

Response:

{
  "invreq_id": "bdbaa2fa505fef38702e3c239241cc4ecbca06be87e6034ef9dd849f0a32646c",
  "active": false,
  "single_use": true,
  "bolt12": "lnr1qqgv27pu76evyr7rc4urea4jcg8uxzsk2fjhzat9wd6xjmn8ypnx7u3qd9h8vmmfvdj3yyrrd35kw6r5de5kueeqwd6x7un92qsqvgnwgcg35z6ee2h3yczraddm72xrfua9uve2rlrm9deu7xyfzr6jqwvfdqzcyypns3vq95jmfcr5en7hek9n8xjpm36mlxtc5q6gqpzyk5w59vrhnxhsgqtn4dvxr7stgwyltx4nal94vmmeeha8gr2neyqyu3024vdy2nef58jpt97d780gtft6yhmhww35qe4uaty5ffmnlgalfj93ycj7qs66",
  "used": false
}