Send Keysend Payment
Description
Every Lightning Network node has a Public Key identifying it to the wider network. While most payments in the Lightning Network require Payment Requests (Charges) QR codes to be created and then paid for, there is another type of payment known as Spontaneous Payment
or Keysend Payment
on a more technical note.
This endpoint exposes the ability to make payment directly to a Lightning Network node Public Key, without the need for a Payment Request / Charge.
Usage
If your system relies on sending Bitcoin over the Lightning Network to specific node Public Keys, this API is what you're looking for.
Additional metadata and TLV record data can be attached to this endpoint as well. Both of these properties/values will be returned on the callbackUrl
POST call from ZEBEDEE.
As with all asynchronous payments in the Lightning Network, in order to receive updates about whether a payment settled, you must provide the callbackUrl
property. As you will note from the response example below, if the Keysend Payment doesn't settle (almost) immediately, you will receive a Payment Processing
response payload. Once it settles, you'll receive the update on the callbackUrl
.
Configuration
Header Parameters
- apikey string required
ZEBEDEE Project API Key
- application/json
Request Body
- amount string required
The amount for the Payment -> in millisatoshis
- pubkey string required
The Public Key for the destination Lightning node
- callbackUrl string
The endpoint ZEBEDEE will POST Charge updates to
- metadata object
Open metadata object property
- tlvRecords array
TLV data records
- 200
{
"message": "Payment processing.",
"success": true,
"data": {
"keysendId": "0d54521c-f41c-4cec-8799-edf9d87cf6b5",
"paymentId": "276e6f54-65fb-4c30-9b86-b44659015cd6",
"transaction": {
"id": "a51bd8d3-1d65-4785-bfd2-3341dc696f84",
"walletId": "cce98a9b-c52a-427c-8cf5-d7ca39c5035e",
"type": "KEYSEND_PAYMENT",
"totalAmount": "3000",
"fee": "2000",
"amount": "1000",
"description": "Keysend Payment",
"status": "TRANSACTION_STATUS_PROCESSING",
"confirmedAt": null
}
}
}