NimBillDocs

Set up your AI

Claude

Install the skill.

A skill is a folder with a SKILL.md that Claude loads when a task matches it.

Install the skill

Claude Code

Run this once to install it for all your projects:

terminal
mkdir -p ~/.claude/skills/nimbill-pay && curl -s https://nimbill.mblob.me/skill.md -o ~/.claude/skills/nimbill-pay/SKILL.md

Or save the file below as .claude/skills/nimbill-pay/SKILL.md in a project.

SKILL.md

The same file is served at https://nimbill.mblob.me/skill.md.

SKILL.md
---
name: nimbill-pay
description: Pay someone on NimBill in NIM or USDT. Use when asked to pay a NimBill tag (like ada@nimbill), a NimBill pay link (https://nimbill.mblob.me/pay/…), a NimBill invoice, or to buy a product from a NimBill board.
---

# Pay with NimBill

NimBill users have a tag like ada@nimbill and a public board at https://nimbill.mblob.me/pay/{tag}. Anyone can pay a board with plain HTTP and JSON. No account or API key. Replace {tag} with the part before @nimbill.

## Steps

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":"<a product id>","quantity":1,"payerName":"<who is paying, shown to the merchant>"}
   To pay an amount instead of buying a product (only when merchant.openAmounts is true), send { "amount": 25, "currency": "USD", "description": "<what it is for>", "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":"<transaction hash>"}
   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}.

## Before you send money
- Show the person who is being paid (merchant name and handle), what for, the total in their currency and the exact coin amount. Get a clear yes first.
- Never send more than the quote, never after quote.expiresAt, and never to an address other than quote.recipient.
- If you can't sign transactions yourself, don't ask for keys or seed phrases. Give the person the invoice link https://nimbill.mblob.me/i/{invoiceId} to pay in Nimiq Pay, or the payment link nimiq:{recipient without spaces}?amount={NIM}&message={memo, URL-encoded}.

## 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.

Full reference: https://nimbill.mblob.me/docs · OpenAPI: https://nimbill.mblob.me/openapi.json