# NimBill > Invoice clients in your local currency. Get paid in NIM or USDT, straight to your Nimiq Pay wallet, verified on-chain. Every NimBill user has a tag like ada@nimbill and a public board at https://nimbill.mblob.me/pay/{tag} where anyone can pay them: buy one of their products, or pay an amount for something. Programs and AI agents can pay a board with plain HTTP and JSON. No account or API key is needed. ## Pay a board Replace {tag} with the part before @nimbill (for ada@nimbill, the tag is ada). 1. Read the board GET https://nimbill.mblob.me/api/pay/{tag} Who you are paying (merchant.name, merchant.handle), whether any amount is accepted (merchant.openAmounts), which coins are accepted (NIM always, USDT when merchant.acceptsUsdt) and the products for sale with their id, name, price and currency. 2. Create the invoice POST https://nimbill.mblob.me/api/pay/{tag}/invoices Body: {"productId":"","quantity":1,"payerName":""} To pay an amount instead of buying a product (only when merchant.openAmounts is true), send { "amount": 25, "currency": "USD", "description": "", "payerName": "…" }. The answer is { invoice } with invoice.id and invoice.total in invoice.currency. 3. Lock the price POST https://nimbill.mblob.me/api/invoices/{invoiceId}/quote Body: {"asset":"NIM"} Use "USDT" to pay in USDT on Polygon. The answer is { quote } with amount (smallest units: Luna for NIM, 1 NIM = 100000 Luna; 6 decimals for USDT), recipient, memo and expiresAt. The price holds for 5 minutes; ask for a new quote if it runs out. 4. Send the payment NIM: send a basic transaction of exactly quote.amount Luna to quote.recipient with quote.memo as the transaction data (UTF-8). The memo is how the payment is matched, so it is required. USDT: send an ERC-20 transfer of exactly quote.amount on Polygon to quote.recipient. USDT can't carry a memo, so the exact amount is what identifies the invoice: don't round it. Send before quote.expiresAt. 5. Confirm it POST https://nimbill.mblob.me/api/invoices/{invoiceId}/verify Body: {"asset":"NIM","txHash":""} Poll every few seconds. status is "pending" until the transaction is in a block, then "paid" with the updated invoice (and its invoice.payment details), or "rejected" with a message. The invoice and its receipt stay at /i/{invoiceId}. ## Rules - No account or API key is needed. Every request and answer is JSON. - Works from a browser on any site too (CORS is open on these endpoints). Requests from other sites never carry a NimBill sign-in. - Errors come back as { error: { code, message } } with a matching HTTP status. message is safe to show to a person. - Payments go wallet to wallet. NimBill never holds the money; it only checks the blockchain. - Each transaction can pay only one invoice. A board accepts at most 30 new invoices every 10 minutes. - payerName is shown to the merchant on their order. Say who you are acting for. ## Pay with NimBill (for online stores) A merchant's own store can create invoices on its board from its server and receive a webhook when each is paid. There is still no API key: the merchant's webhook secret (Settings → Webhooks) signs both ways. - Create: POST https://nimbill.mblob.me/api/pay/{tag}/invoices with the header NimBill-Signature: t=,v1=.")>. Signed requests may add reference, metadata and returnUrl. Save invoice.id and send the customer to https://nimbill.mblob.me/i/{invoice.id}. - Receive: NimBill POSTs { id, type: "invoice.paid", test, data: { invoice } } to the store's URL, signed the same way. Verify it on the raw body, skip duplicate ids, match the order by invoice.id and check total and currency, answer 2xx within 10 seconds. Failures are retried for about 3 days. - Guide: https://nimbill.mblob.me/docs/webhooks ## Links - [Developer docs](https://nimbill.mblob.me/docs): why and how, a quick start, and every endpoint with examples - [AI assistants](https://nimbill.mblob.me/ai): setups for Claude, ChatGPT, Cursor, Grok and your own agent - [MCP Agent Wallet](https://nimbill.mblob.me/mcp): give an MCP client its own Nimiq wallet - [OpenAPI](https://nimbill.mblob.me/openapi.json): the API as OpenAPI 3.1 - [Agent skill](https://nimbill.mblob.me/skill.md): a SKILL.md to install the steps above as a skill - [A board as JSON](https://nimbill.mblob.me/api/pay/{tag}): includes a howToPay section with that board's URLs filled in - [Payments made with NimBill](https://nimbill.mblob.me/stats): public list, each with its transaction