invoice_create
Create a payment request: who receives, which token, how much, on which network. Returns invoice.id, invoice.label (INV-XXXX-XXXX, what people copy), invoice.url (share this; it previews with the QR on WhatsApp and Telegram) and invoice.qr (PNG). No signature or API key needed. Only VERIFIED tokens of the network are accepted, by address or symbol — an unverified token is refused because a cloned "USDC" with its own pool would let the creator sell a fake at any price. The payer can pay with ANY token on that network.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| memo | No | Optional note, up to 80 chars, visible to anyone with the link. | |
| token | Yes | Token to receive: address/mint or symbol of a verified token on this network. | |
| amount | Yes | Human decimal amount, e.g. "100". Decimals come from the token list, not from you. | |
| chainId | Yes | EVM: integer from GET /v1/chains (1, 10, 56, 100, 137, 8453, 42161, 43114, 130). Solana: string from GET /v1/svm/chains ("solana-mainnet"). | |
| recipient | Yes | Wallet that receives. EVM 0x address, or base58 on Solana (case-sensitive). | |
| confidential | No | Optional, Solana only. A private (confidential) invoice hides the receiving wallet from anyone with the link (invoice_get returns recipient: null), and every payment route screens the payer first: OFAC SDN list plus the issuer freeze of USDC and EURC (Circle), USDT (Tether), PYUSD and USDG (Paxos) and USD1 (World Liberty), the issuer freeze index, and a fund trail up to three hops back through the same checks (a flagged sender on the first hop blocks; on hops two and three it only warns). These are checks of the paying wallet, whatever token it pays with. A blocked payer gets payer_blocked. |