Nijipe DevelopersREST API SPECIFICATION
Access Merchant Hub
Product Preview

Hosted Checkout

Accept Bitcoin and Lightning payments through a production ready checkout experience without building payment UI from scratch.

Generate invoices through a simple API and redirect customers to a secure hosted checkout page with real time payment status, QR codes, expiry management, and webhook automation.

Nijipe Store15.00 USD
Bitcoin
Lightning
Waiting for Payment
Expires in: 09:58

Engineered for Scale

Launch Faster

Skip custom payment UI development. Focus on your core product while we handle the checkout edge cases.

Bitcoin + Lightning

Accept both payment methods through a unified checkout experience. Users choose their preferred network seamlessly.

Real-Time Status

Track payments as they move from pending to confirmed via WebSockets, instantly reflecting state changes.

Merchant Controlled Settlement

Customers pay directly to merchant-controlled infrastructure. Nijipe never takes custody of funds.

Payment Infrastructure Without the Frontend Work

A clear separation of concerns. You handle the business logic, we handle the payment UX and infrastructure.

Your Store
API Call
Nijipe
Hosted Checkout
& Webhooks
Your Wallet
Direct Settlement

Launch Checkout With One API Call

Create an invoice via our REST API and immediately redirect your user to the returned checkoutUrl. We handle the rest, from displaying QR codes to emitting webhooks upon payment detection.

  • Returns a secure, short-lived checkout session URL
  • Automatically localizes to the user's timezone
  • Gracefully handles underpayments and overpayments
  • Triggers cryptographically signed webhooks to your backend
create_invoice.js
const invoice = await nijipe.createInvoice({amount: 1500,currency: "USD",metadata: { orderId: "ord_987" }});// Redirect customer to hosted checkoutwindow.location = invoice.checkoutUrl;
API Response
{"invoiceId": "inv_123abc","checkoutUrl": "https://pay.nijipe.com/i/inv_123abc","status": "pending"}

Complete Lifecycle Management

Hosted Checkout handles every possible state of a Bitcoin transaction so your frontend doesn't have to.

Happy Path

pending
Waiting for customer to broadcast transaction.
detected
Tx seen in mempool. (0-conf)
confirmed
Transaction confirmed on-chain.

Edge Cases Handled

underpaid
overpaid
expired
canceled
failed

If a user underpays, the checkout UI instantly updates to request the remaining balance. If they overpay, it confirms and flags the invoice for your attention. Expired invoices prevent late payments.

Why Use Hosted Checkout?

FeatureCustom BuildNijipe Hosted Checkout
Build Payment UIRequiredNo
QR Code GenerationRequiredIncluded
Bitcoin SupportCustom integrationIncluded natively
Lightning SupportCustom node mgmtIncluded natively
Expiry HandlingManual cron jobsAutomatic state transitions
Payment MonitoringManual node pollingIncluded realtime WebSockets
WebhooksManual architectureIncluded (HMAC signed)
Mobile OptimizationManual CSSIncluded (Responsive)

Non-Custodial by Design

Merchant funds never pass through Nijipe-controlled wallets. Keys stay with you.

Signed Webhooks

Verify every payment event securely with HMAC-SHA256 payload signatures.

Merchant Controlled Settlement

Customers pay directly to merchant-controlled Bitcoin and Lightning infrastructure.

Real Time Monitoring

Track invoices, mempool activity, and network confirmations with sub-second latency.

Frequently Asked Questions

Can I customize the checkout page?

Yes. Configure branding, logo, success URLs, cancel URLs, and checkout settings directly from the dashboard or via API metadata.

Does Nijipe custody funds?

No. Payments settle directly to merchant-controlled infrastructure via BIP84 derivation from your provided xpub.

Does Hosted Checkout support Lightning?

Yes. Merchants can accept Lightning payments using their own connected Lightning infrastructure or our shared infrastructure.

Does Hosted Checkout work on mobile?

Yes. The checkout experience is fully responsive and optimized for mobile Bitcoin wallets using standard URI schemes.

Accept Bitcoin Payments Without Building a Checkout From Scratch

Launch a production-ready Bitcoin and Lightning payment experience in minutes.