Sign in
Me

Send a payment from a wallet.

Changed on
post/v1/me/wallets/{wallet_id}/payments

Request

  • The document declares no server URL.
  • Auth: HTTP bearer

Path parameters

wallet_idstring uuid required

Request body

amount_msatinteger nullable

Amount in millisatoshis. Only necessary if the input does not specify an amount (empty Bolt11, LNURL or LN Address)

commentstring nullable

Comment of the payment. Visible by the recipient for LNURL payments

inputstring required

Recipient. Can be a Bolt11 invoice, LNURL or LN Address.

wallet_idstring uuid nullable

Wallet ID to pay from. Required by admin endpoints; derived from the path on wallet-scoped endpoints.

Example request

{
  "input": "hello@numeraire.tech"
}

Response

Payment Sent

amount_msatinteger required

Amount in millisatoshis.

created_atstring date-time required

Date of creation in database

descriptionstring nullable

Description

errorstring nullable

Error message

fee_msatinteger nullable

Fees paid. Populated when a new channel is opened to receive the funds

idstring uuid required

Internal ID

ledger'Lightning' | 'Internal' | 'Onchain' required

The ledger a transaction settles on.

payment_timestring date-time nullable

Payment time

status'Pending' | 'Settled' | 'Failed' required

Lifecycle status of a payment.

updated_atstring date-time nullable

Date of update in database

wallet_idstring uuid required

Wallet ID

Example response

{
  "error": "failed to pay error message",
  "internal": {
    "btc_address": "bc1q...",
    "ln_address": "hello@numeraire.tech",
    "payment_hash": "b587c7f76339e3fb87ad2b..."
  },
  "lightning": {
    "ln_address": "hello@numeraire.tech",
    "payment_hash": "b587c7f76339e3fb87ad2b..."
  }
}

Changes