Dev Tools

BlockPay Developer
API Infrastructure.

API first financial infrastructure for merchants, platforms, and developers. BlockPay abstracts crypto complexity into simple, reliable API calls — so you ship faster and your users never touch a wallet.

Get API Access Explore APIs
Overview

One platform.
Every financial primitive.

BlockPay provides the payment infrastructure that developers need to build with crypto — without deep blockchain expertise. The same API layer that powers in store tap to pay also handles payroll, invoicing, and programmatic disbursements.

Merchants
Accept Anywhere

Embed a checkout widget, call a single REST endpoint, or wire up an NFC terminal. BlockPay routes payments across chains and settles directly to your wallet with no custodian and no hold periods.

REST · Webhooks · NFC · Multi chain
Platforms
Build on Top

White label the payment layer. Platform partners get sub merchant provisioning, per transaction revenue splits, and a dedicated API tier with higher rate limits and SLA guarantees.

Sub merchants · Revenue splits · SLA tier
Developers
Ship in an Afternoon

TypeScript SDK with full type coverage. Sandbox environment with deterministic test transactions. WebSocket streams for real time on chain events. Documentation written by engineers, for engineers.

TypeScript SDK · Sandbox · WebSocket · Docs
Core API Services

Three APIs.
Infinite applications.

Each BlockPay API maps directly to a financial workflow — payments, payroll, and invoicing. These API services operate alongside BlockPay's NFC Tap To Pay system, giving businesses both in store and online payment capabilities from a single platform. They share a common authentication model, webhook format, and TypeScript SDK surface so context switches cost nothing.

A — Online Transactions

POS API

Checkout
Hosted + Embedded

POST /v1/payments/session returns a hosted checkout URL or an embeddable coin selector widget. Configure accepted chains, timeout behavior, and redirect URLs per session.

Hosted · Embedded widget · Configurable per session
NFC
Tap to Pay Trigger

NFC hardware taps call POST /v1/pos/checkout with a device token and amount. Real time confirmation events fire to your webhook within seconds of on chain finality.

NFC triggered · Hardware token · <10s confirm
Chains
Multi chain Routing

Accept XRP, SOL, BTC, ETH, USDC, and RLUSD. BlockPay auto detects the sender's chain and handles routing. You receive a normalized payload with no chain specific parsing in your code.

XRP · SOL · BTC · ETH · USDC · RLUSD
Webhooks
Real time Confirmation

Each payment session fires a signed webhook on confirmation: tx hash, amount, FX rate at time of settlement, and merchant metadata you passed at session creation. Retry with exponential backoff.

Signed payload · HMAC SHA256 · At least once delivery
B — Payroll

Payroll API

Batch
Single payload Disbursements

Submit a JSON array of recipients, wallet addresses, and amounts to POST /v1/payroll/batch. BlockPay handles gas estimation, sequencing, and on chain confirmation for every line item.

Batch JSON · Gas estimation · Per recipient status
Stablecoins
Pay in USDC or RLUSD

Employees receive stablecoins directly to any self custodial wallet. Optionally configure auto conversion to local fiat via BlockPay's conversion layer — recipients choose their settlement preference.

USDC · RLUSD · Self custodial · Auto convert
C — Invoicing

Invoicing API

Generate
Programmatic Invoices

POST /v1/invoices creates a payment linked invoice with a unique on chain identifier. Specify fiat amount, preferred settlement coin, and due date — BlockPay calculates the crypto equivalent at lock in.

Fiat input · Dynamic FX · On chain ID · PDF export
Status
Lifecycle Webhooks

Track invoice state from created → sent → viewed → paid. Each state transition fires a signed webhook. Query GET /v1/invoices/:id at any time for current status, payment hash, and FX rate at settlement.

State machine · Signed webhooks · Queryable history
Developer Experience

Test before you ship.
Ship with confidence.

Inspired by the best blockchain developer tooling — BlockPay's dev environment gives you real time transaction simulation, WebSocket streams, and a full testnet that behaves exactly like production.

Sandbox
Full Testnet Simulation

Point the SDK at api.sandbox.blockpay.io and fire real API calls against a dedicated testnet. Deterministic transaction outcomes, configurable confirmation delays, and no mainnet tokens required.

Testnet · Deterministic outcomes · Zero real funds
WebSocket
Real time Transaction Feed

Subscribe to wss://api.blockpay.io/v1/stream for live on chain events. Filter by session ID, wallet address, or merchant account. Block confirmations, payment state changes, and error events — all in one stream.

WSS · Block events · Wallet subscriptions · Filters
RPC
Query Interface

HTTP RPC interface for ad hoc queries: wallet balance, transaction history, fee estimates, and chain status. Mirrors the WebSocket event schema so your data models stay consistent across both interfaces.

HTTP RPC · Balance · Tx history · Fee estimates
SDK
TypeScript Client

Strongly typed client for every endpoint. Bundled retry logic, exponential backoff, idempotency key management, and request signing — the infrastructure plumbing ships with the SDK so you don't build it twice.

TypeScript · Node.js · Auto complete · Idempotency
Monitor
Dashboard Inspector

Every API call made against your account is logged in the developer console with request/response bodies, latency, and chain event correlation. Replay failed webhooks with a single click.

Request log · Webhook replay · Latency trace
Auth
API Key Management

Scoped API keys with per endpoint permissions. Separate keys for sandbox and production. Rotate keys without downtime via the console. HMAC SHA256 request signing for webhook delivery verification.

Scoped keys · Sandbox / prod · HMAC SHA256
Market Landscape

Emerging API infrastructure
for crypto & AI.

The next generation of financial APIs is being shaped by Web3 native payment primitives and AI first transaction systems. BlockPay is building at the intersection of both — combining proven crypto infrastructure with the protocols that will power autonomous AI economies.

Web3 API Payments
Dhali — High Frequency Monetization

Dhali pioneers real time API monetization through Web3 native payment primitives. Payment based authentication replaces traditional API keys — each API request carries cryptographic proof of payment, enabling per call billing with multi chain support and zero subscription friction.

Key model

Authentication and payment in a single cryptographic transaction. No subscriptions, no keys — the payment IS the credential.

Per call billing · Payment auth · Multi chain · High frequency
AI Agent APIs
Arch Tools — APIs Built for AI Agents

Arch Tools is building the first API platform where AI agents are first class consumers. Agents authenticate and pay simultaneously using USDC and a single unified API key — enabling fully autonomous machine to machine transactions. No human approval, no subscription management.

Key model

AI agents call and pay for APIs autonomously. One key, one payment rail — agents operate without human intervention at every step.

Agent callable · USDC · One key · Fully autonomous
Context

Dhali and Arch Tools are independent platforms. BlockPay references their models as representative of the emerging crypto API landscape — the same landscape BlockPay's infrastructure is designed to serve. Our roadmap draws from these patterns to inform next generation payment primitives.

Future Feature

AI Agent Transactions API.
In development.

In Development

The next frontier in payments infrastructure — enabling AI agents to initiate, authenticate, and settle transactions autonomously, without human interaction at any step. BlockPay is building the protocol layer to make autonomous machine payments as simple as today's REST API calls.

Autonomous
Agent initiated Payments

An AI agent calls your BlockPay endpoint, presents a wallet signed proof, and the payment executes on chain — all in a single round trip. No human approval required at any step in the flow.

No human approval · Single round trip · On chain execution
Monetization
Pay per API call Billing

AI agents pay for API usage in USDC or RLUSD — per request, in real time. Eliminates subscription overhead for machine to machine workflows. Billing settled on chain and auditable by all parties.

USDC · RLUSD · Per call · Machine to machine · Auditable
Auth
Cryptographic Auth

Emerging systems allow agents to authenticate and pay simultaneously via a single wallet signed transaction — replacing static API keys with cryptographic proofs that are payment and credential in one operation.

Wallet signed · Payment + Auth combined · No static keys
Development status

The AI Agent Transactions API is on BlockPay's public roadmap. Design is in progress — implementation timeline has not been announced. Join the developer waitlist to receive updates and early access when the beta opens.

Start building

API access.
First endpoint free.

Join the developer waitlist and get early access to BlockPay's full API suite — POS, Payroll, Invoicing, and AI Agent APIs as they roll out.

Get API Access View Documentation Contact Developer Team