Skip to main content
PUT
/
v3
/
lightning_invoice_bolt11
/
{id}
cURL
curl --request PUT \
  --url https://service-sandbox.tazapay.com/v3/lightning_invoice_bolt11/{id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metadata": "{\"key1\": \"value1\", \"key2\": \"value2\"}"
}
'
{
  "status": "success",
  "message": "",
  "data": {
    "id": "l11_abc123xyz",
    "object": "lightning_invoice_bolt11",
    "amount": 123456,
    "d_tag_memo": "Payment for order #7890",
    "h_tag": null,
    "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.

Path Parameters

​
id
string
default:l11_ag7a8f7agegfa
required

ID of an existing lightning invoice

Body

application/json
​
metadata
string<json>

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

Example:

"{\"key1\": \"value1\", \"key2\": \"value2\"}"

Response

200 - application/json
​
status
string

The status of the request - success or failure

​
message
string

Additional information about the status

​
data
string

The updated lightning_invoice_bolt11 object