Skip to main content
POST
/
v3
/
lightning_invoice_bolt11
cURL
curl --request POST \
  --url https://service-sandbox.tazapay.com/v3/lightning_invoice_bolt11 \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "12345600",
  "d_tag_memo": "Payment for order #7890",
  "h_tag_memo": "<string>",
  "expiry_interval": "4800",
  "metadata": "<string>"
}
'
{
  "status": "success",
  "message": "",
  "data": {
    "id": "l11_abc123xyz",
    "object": "lightning_invoice_bolt11",
    "amount": 123456,
    "d_tag_memo": "Payment for order #7890",
    "collect": "col_98765",
    "expiry_interval": 3600,
    "metadata": {
      "order_id": "7890",
      "customer_id": "cust_456"
    },
    "status": "active",
    "payment_status": "unpaid",
    "created_at": "2025-09-28T08:15:30Z",
    "updated_at": "2025-09-28T08:20:45Z"
  }
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
​
amount
integer<int64>
default:12345600
required

Amount in BTC. The precision is 8 decimal places

​
d_tag_memo
string
default:Payment for order #7890

This will be included in the d-tag. If both d_tag_memo and h_tag_memo are provided, only h_tag will be used

​
h_tag_memo
string

SHA-256 of the d_tag_memo. If both d_tag_memo and h_tag_memo are provided, only h_tag_memo will be used

​
expiry_interval
integer
default:4800

The expiry of the invoice in seconds. Default value is 3600 (1 hour)

​
metadata
string<json>

Set of key-value pairs to attach to the lightning_invoice_bolt11 object

Response

200 - application/json
​
status
string

success or failure

​
message
string

Message related to the action

​
data
string<json>

The lightning invoice bolt11 object