Create a one-off Hypawave invoice (Path 3a seller)
create_invoiceCreate a single-settlement invoice for a buyer to pay once. Returns invoice ID and access token for settlement, with activation fee to be paid before invoice goes live.
Instructions
Create a single-settlement invoice: one buyer pays once, creator-direct to your payment_destination. Returns the buyer payload (invoice_id + access_token — forward BOTH to the buyer, who settles it with pay_invoice) plus an activation fee bolt11 that must be paid before the invoice goes live. Attach a file first with attach_file(invoice_id=...) if selling a file — content seals at activation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | ||
| currency | No | Default USD | |
| due_date | Yes | ISO date the invoice is due, e.g. 2026-07-31 | |
| expires_in | No | ||
| description | No | ||
| client_email | Yes | Buyer contact email (required by the API) | |
| company_name | No | ||
| client_last_name | Yes | ||
| client_first_name | Yes | ||
| execution_webhook | No | ||
| pay_activation_fee | No | Pay the activation fee automatically via NWC (attach files first!) | |
| payment_destination | Yes | YOUR Lightning Address or LNURL-pay URL |