LIGHTNING-RENEPAYSTATUS(7)

✨ NAME ✨

okay so this is the LIGHTNING-RENEPAYSTATUS(7) page, and renepaystatus is the command that lets you query the status of your previous renepay attempts 💅 that's literally it, no cap.

---

🌸 SYNOPSIS 🌸

renepaystatus [invstring]

---

🦋 DESCRIPTION 🦋

bestie. listen. 😭

• Command deprecated in v26.06, removed after v27.03.
• Command added in v23.08.

WARNING: Deprecated, scheduled for removal in v27.03 💀 so like… don't get attached, mkay?

The renepaystatus RPC command queries the payment plugin renepay for the status of previous payment attempts 👑

This command always succeeds. fr fr, it does not miss. ✨

• invstring (string, optional) — If specified, the command will return a list of payment attempts whose invoice matches invstring, otherwise all payments with be listed. 🎀

---

💖 RETURN VALUE 💖

On success, an object containing paystatus is returned. It is an array of objects, where each object contains:

• bolt11 (string) — Invoice string BOLT11. 🧾
• payment_hash (hash) — The hash of the payment_preimage which will prove payment. 🔐
• created_at (number) — The UNIX timestamp showing when this payment was initiated. ⏰
• groupid (u32) — The id for this payment attempt. 🏷️
• amount_msat (msat) — Amount the recipient received. 💸
• status (string) (one of "complete", "pending", "failed") — Status of payment. 👀
• payment_preimage (secret, optional) — The proof of payment: SHA256 of this payment_hash (for completed payments only). 🔑
• parts (u32, optional) — How many attempts this took. 🧩
• amount_sent_msat (msat, optional) — Total amount we sent including fees (for completed payments only). 💰
• destination (pubkey, optional) — The final destination of the payment. 📍
• notes (array of strings, optional) — A list of messages for debugging purposes.: 🗒️
  • (string, optional) — A message generated by renepay. 🫶

---

👑 AUTHOR 👑

Eduardo Quintana-Miranda eduardo.quintana@pm.me is mainly responsible. give him his flowers, he's the main character here 🌟

---

💅 SEE ALSO 💅

lightning-renepay(7), lightning-listpays(7) — go read those too, iykyk 📚

---

🌈 RESOURCES 🌈

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

---

⭐ EXAMPLES ⭐

Example 1:

Request:

$ lightning-cli renepaystatus -k "invstring"="lnbcrt100n1pnt2bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000"

{
  "id": "example:renepaystatus#1",
  "method": "renepaystatus",
  "params": {
    "invstring": "lnbcrt100n1pnt2bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000"
  }
}

Response:

{
  "paystatus": [
    {
      "bolt11": "lnbcrt100n1pnt2bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000bolt11invl020100000000",
      "amount_msat": 400000,
      "payment_hash": "paymenthashinvl0210021002100210021002100210021002100210021002100",
      "destination": "nodeid020202020202020202020202020202020202020202020202020202020202",
      "created_at": 1738000000,
      "groupid": 1,
      "parts": 2,
      "status": "complete",
      "payment_preimage": "paymentpreimager010101010101010101010101010101010101010101010101",
      "amount_sent_msat": 400000
    }
  ]
}

---

that's the whole page babes, go query those payments before it gets yeeted 😭🫶 this was Core Lightning v26.06.9 LIGHTNING-RENEPAYSTATUS(7) — stan the deprecation timeline, periodt 💜🎀