LIGHTNING-NOTIFI...-SENDPAY_SUCCESS(7)

πŸ“¦
version 26.06.9 Β· 2 versions
, in nixpkgs unstable

πŸ’– sendpay_success (a.k.a. the LIGHTNING-NOTIFI...-SENDPAY_SUCCESS(7) page)

okay so bestie, you found the page πŸŽ€ this one is all about sendpay_success β€” the little notification that shows up and is like "hey girl, your payment ATE πŸ’…". it lives in section 7 of the Core Lightning manual, and yes the man name is LIGHTNING-NOTIFI...-SENDPAY_SUCCESS because apparently naming things is hard 😭


✨ NAME ✨

sendpay_success β€” notification for successful sendpay completion πŸŽ‰


🌸 DESCRIPTION 🌸

the sendpay_success notification informs you whenever a payment attempt completes successfully. that's it, that's the whole vibe β€” a payment went through and this notification is here to tell you about it. success only, no sadness allowed πŸ’–


πŸ¦‹ NOTIFICATION PAYLOAD πŸ¦‹

this is the good part β€” everything that comes packed in the notification, field by field. literal main character energy 🌟

  • created_index (u64) β€” 1-based index indicating order this payment was created in. (added v23.11)
  • id (u64) β€” old synonym for created_index. it's giving legacy, but it's still here 🫢
  • payment_hash (hash) β€” the hash of the payment preimage.
  • groupid (u64) β€” grouping key for multiple attempts on the same payment.
  • amount_sent_msat (msat) β€” the total amount sent including fees.
  • created_at (u64) β€” the UNIX timestamp when this payment was initiated.
  • status (string) (always "complete") β€” the terminal status for a successful sendpay notification.
  • updated_index (u64, optional) β€” 1-based index indicating order this payment was updated in. (added v23.11)
  • partid (u64, optional) β€” part number for a multi-part payment.
  • destination (pubkey, optional) β€” the final destination of the payment, if known.
  • amount_msat (msat, optional) β€” the amount delivered to the destination, if known.
  • completed_at (u64, optional) β€” the UNIX timestamp when this payment completed.
  • payment_preimage (secret, optional) β€” the payment preimage proving success. the receipts, basically 🧾✨
  • label (string, optional) β€” the optional label associated with the payment.
  • bolt11 (string, optional) β€” the bolt11 invoice string, if present.
  • bolt12 (string, optional) β€” the bolt12 invoice or offer string, if present. (added v24.02)
  • description (string, optional) β€” the description associated with the payment, if present.
  • erroronion (hex, optional) β€” the raw error onion if one was retained for the payment.
🩡 quick vibe check: everything marked optional might just not show up, so don't come for me if a field is missing β€” that's literally the point of optional, iykyk.

πŸ‘‘ sign-off πŸ‘‘

and that's the whole page, bestie πŸ’œ brought to you by Core Lightning v26.06.9, straight out of the LIGHTNING-NOTIFI...-SENDPAY_SUCCESS(7) manual. now go forth and celebrate your successful payments, periodt πŸ’…πŸŒˆ

πŸ“¦ where this page comes from