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'sdoc/payment-uri.md, so any wallet that supports it can pay them.