Merchants

Pay with NORTH buttons

Make a button, a payment link and a QR code for your site, your shop or an invoice. Buyers can pay in their browser with the tncoin.xyz web wallet, in a wallet app, or by scanning the code on their phone. Nothing here holds your NORTH: payments go straight to your address.

Checking that you were paid

  • Use a new address for each order. Then the address itself tells you which order was paid. The web wallet shows a fresh address after each payment it receives, and TrueNorth Core makes one with getnewaddress.
  • Watch for the payment. It's confirmed once it's in a block, about 2 minutes after it's sent. Your wallet shows it, or your site can ask the community explorer, which allows requests from any site:
    const r = await fetch('https://tnexplore.com/api/v1/address/' + address + '/summary?limit=1');
    const { total_received } = await r.json();   // in NORTH, confirmed payments only
    if (total_received >= orderTotal) markPaid();
  • For bigger amounts, wait for more blocks. One confirmation is fine for small purchases. For larger ones, wait a few more blocks before you ship anything, and for the biggest, check with your own node.
  • Payment links follow TrueNorth's format, the truenorth: scheme described in the TrueNorth repository's doc/payment-uri.md, so any wallet that supports it can pay them.