NimBillDocs

Get started

How payments work

Five calls, one blockchain check.

Every payment, from a person or a program, goes through the same steps. The only part NimBill can't do for you is sign the transaction: that happens in a wallet.

Five calls, one blockchain check

  1. 01

    Read

    GET the board: who, what, which coins.

  2. 02

    Invoice

    POST what you're paying for.

  3. 03

    Quote

    Lock the exact coin amount for 5 minutes.

  4. 04

    Send

    Your wallet sends it, with the memo.

    In a wallet

  5. 05

    Verify

    NimBill checks the chain. Paid.

Each call has its own page under Board API, and the quick start runs all five.

Why a separate verify step?

A transaction hash on its own proves nothing. NimBill reads the transaction from a Nimiq or Polygon node and checks the recipient, the amount, the memo and the time before it marks an invoice paid. Each transaction can pay only one invoice.

Two ways to pay

Hand the payment to a person to approve in their wallet, or let a program with its own wallet pay on its own. Most AI assistants can't hold money, so they hand off.