LNPay Docs
LNPay Docs
Getting Started
Basics
How to Authenticate
Sending Requests
Error Handling
How to Structure Your App
Wallet
The Wallet Object
Create Wallet
Get Balance
Get Transactions
Generate Invoice
Pay Invoice
Keysend (New!)
Transfers Between Wallets
LNURL Withdraw
LNTX (LN Invoice)
LnTx (Lightning Invoice) Object
Get Invoice Status
Paywall
Create Paywall
Webhooks
Webhook Intro
Node
Decode Invoice
Powered by GitBook

Keysend (New!)

Initiate a keysend payment from your wallet to a destination pubkey

post
PostWalletKeysend

https://lnpay.co/v1/wallet/:access_key/keysend
Request
Response
Request
Path Parameters
wallet_access_key
optional
string
Access key with withdraw permission (e.g. waka_ or waki_)
Body Parameters
passThru
optional
object
data to pass along with this invoice for webhooks (e.g. ticketId, etc)
dest_pubkey
required
string
Pubkey of destination node
num_satoshis
required
integer
satoshis
custom_records
optional
object
key:value pairs to be sent in the onion. key must be an integer greater than 65536. Too many values here will break things.
Response
201: Created
Keysend Sent!
{
    "id": "wtx_s1xa5yZFlCegcgtXkaeo34",
    "created_at": 1595165573,
    "num_satoshis": -2,
    "user_label": "2 keysend to 033868c219bdb51a33560d854d500fe7d3898a1ad9e05dd89d0007e11313588500",
    "wal": {
        "id": "wal_czDztN5eJ4r5sJ",
        "created_at": 1582461859,
        "updated_at": 1595165573,
        "user_label": "My Postman Collection Wallet",
        "balance": 211,
        "statusType": {
            "type": "wallet",
            "name": "active",
            "display_name": "Active"
        }
    },
    "wtxType": {
        "layer": "ln",
        "name": "ln_withdrawal",
        "display_name": "LN Withdrawal"
    },
    "lnTx": {
        "id": "lntx_gTMCJKFywtc2ZMWFwge0vpcE",
        "created_at": 1595165573,
        "ln_node_id": "lnod_2s4yfYA",
        "dest_pubkey": "033868c219bdb51a33560d854d500fe7d3898a1ad9e05dd89d0007e11313588500",
        "payment_request": "033868c219bdb51a33560d854d500fe7d3898a1ad9e05dd89d0007e11313588500:2",
        "r_hash_decoded": "efa5d7a28c26566dbc854dce4b4c15c16afa4488e0130b393a88c2d255ae6599",
        "memo": "2 keysend to 033868c219bdb51a33560d854d500fe7d3898a1ad9e05dd89d0007e11313588500",
        "description_hash": null,
        "num_satoshis": 2,
        "expiry": 432000,
        "expires_at": null,
        "payment_preimage": "6e5a9be8db789bdd6c4d603b8a357561c0dd1be0fe278a4ecdbfd8e228a8fc11",
        "settled": 1,
        "settled_at": 1595165573,
        "is_keysend": 1,
        "custom_records": {
            "5482373484": "6e5a9be8db789bdd6c4d603b8a357561c0dd1be0fe278a4ecdbfd8e228a8fc11"
        }
    },
    "passThru": {
        "method": "api",
        "ticketId": "23"
    }
}
400: Bad Request
Some error
{
    "name": "Bad Request",
    "message": "Failure reason: FAILURE_REASON_NO_ROUTE",
    "code": 0,
    "status": 400
}

See this LND release for more information about keysend: https://github.com/lightningnetwork/lnd/releases/tag/v0.9.0-beta​

curl
curl
$ curl -u pak_O0iUMxk8kK_qUzkT4YKFvp1ZsUtp: \
-H "Content-Type: application/json" \
-X POST \
-d '{"dest_pubkey":"033868c219bdb51a33560d854d500fe7d3898a1ad9e05dd89d0007e11313588500","num_satoshis":2}' \
https://lnpay.co/v1/wallet/waka_kqvaiFFl4Tjq4rgAXlwsu6/keysend
​
# Note we are using the "admin" access_key as denoted by "wa_"
Wallet - Previous
Pay Invoice
Next - Wallet
Transfers Between Wallets
Last updated 6 months ago