Build the Future of Payments.
Integrate with NHBCoin's L1 network to leverage low-fee transactions, native loyalty, and a seamless user experience. All on a fully EVM-compatible chain.
Jump into the NHBCoin REST API
No SDK to install -- create a checkout invoice, read chain state, and verify webhooks with plain HTTP calls from whatever stack you already use.
Who this is for
These docs are for developers adding NHBCoin to a product: merchants and platforms that take payments or recurring billing, marketplaces that need escrow, businesses that run a rewards program, apps that want a Login with NHBCoin button, and operators who run their own node.
How the pieces fit together
Most integrations use one or more of three surfaces. Hosted REST APIs, authenticated with an API key, cover checkout invoices, subscription plans and escrow. The node's JSON-RPC API at api.nhbcoin.com serves public reads and accepts signed transactions, which is how the loyalty engine works. OAuth 2.0 powers Login with NHBCoin. Payment and subscription results come back to your server as signed webhooks, and a node of your own plus the nhb-cli tool give you direct access to the chain.
Guides and references
Every page in the developer docs, grouped by what you are trying to do.
Start here
- Introduction: Why Build on NHBCoin?
Why NHBCoin is a purpose-built payment network rather than a general-purpose chain, what it gives builders, and the core concepts used across these docs.
- NHBCoin REST API Quickstart
There is no npm SDK: get a live API key, create a checkout invoice and read chain state with plain HTTP calls from any stack.
- JSON-RPC API Reference
The JSON-RPC methods exposed by the node, the signed-request headers used by the Escrow Gateway, rate limits, native transaction construction and the OAuth 2.0 endpoints.
Build
- Guide: Accepting Payments with NHBCoin
Create a checkout invoice from your backend, send the customer to the hosted payment page, and fulfill the order only after a signature-verified payment.completed webhook.
- Guide: Recurring Billing with NHBCoin Subscriptions
Create a billing plan, send subscribers to the hosted subscribe page where one signature authorizes future charges, and follow billing with signed webhooks.
- Guide: Building with On-Chain Escrow
Lock NHB or ZNHB until both sides agree a trade is done, through the hosted Escrow Gateway or with your own signed transactions.
- Guide: The Loyalty Rewards Engine
Register a business, fund rewards from a paymaster wallet, add merchant addresses and create reward programs with directly signed on-chain transactions.
- Guide: The 'Login with NHBCoin' SDK
Add Login with NHBCoin using a standard OAuth 2.0 authorization-code flow that returns a verified email address and wallet identifiers.
Run and operate
- Running a Node
Install Go 1.24.3, build the binaries, set your secrets, configure config.toml and keep a node running.
- Using the CLI (nhb-cli)
Use nhb-cli to generate a wallet, check balances, stake and un-stake ZNHB, send heartbeats and deploy contracts through a running node.