Qorebox
Sign in

Webhooks

qbill's webhook runs in one direction: NRS → qbill. It notifies qbill the moment an invoice involving your business is transmitted through the four-corner network, so it appears under Invoices → Received immediately instead of waiting for the next scheduled pull.

Not an outbound event subscription

If you're looking for a way to have qbill call your own server when one of your invoices clears or is rejected, that feature doesn't exist yet — check invoice status via the API or the dashboard instead. This page is specifically about invoices other businesses send to you.

What it is

Every organisation gets a unique, auto-generated webhook URL. Pasting it into your NRS developer portal, under Access Point Provider settings, lets NRS push received invoices to qbill in real time rather than qbill having to poll for them.

Registering it

A webhook URL can only be generated once your NRS API credentials and business ID are registered.

  1. Add your NRS API credentials and signing certificate under Organization in the dashboard, if you haven't already.
  2. Once registered, the NRS Webhook URL card on that same page generates your organisation's URL. Copy it.
  3. In your NRS developer portal, under Access Point Provider settings, paste the URL in as your delivery endpoint.

Received invoices

Every received invoice records how it arrived, so you can tell real-time delivery from a manual check.

JSON — received invoice (excerpt)
{
  "id": "6b1c9a44-...",
  "source": "webhook",
  "buyerDecisionStatus": "pending"
}

source is either "webhook" (delivered via the registered URL) or "pull" (fetched by clicking Pull now in the dashboard, available as a fallback whether or not a webhook is registered). Once received, you can accept, dispute, or reject it from the dashboard.