NimBillDocs

Board API

Confirm the payment

After sending, report the transaction hash. NimBill reads it from the blockchain and checks the recipient, the amount, the memo and the time before marking the invoice paid. Poll every few seconds until it isn't pending.

POSThttps://nimbill.mblob.me/api/invoices/{id}/verify

Path parameters

Path

id stringrequired
The invoice id.

Body

Body (JSON)

asset stringrequired
The coin you paid with. (NIM | USDT)
txHash stringrequired
The transaction hash: 64 hex characters for NIM, 0x + 64 for Polygon.

Request

Example request
curl -X POST https://nimbill.mblob.me/api/invoices/89mwch33sp/verify \
  -H 'content-type: application/json' \
  -d '{"asset":"NIM","txHash":"8f3c…a91e"}'

Response

Example response · 200
{
  "status": "paid",
  "invoice": {
    "id": "89mwch33sp",
    "number": "INV-0042",
    "status": "paid"
  }
}

When it goes wrong

  • status “pending”: not in a block yet, ask again
  • status “rejected”: the transaction doesn't pay this invoice (message says why)