Build on Settlematic
OpenAPI-documented REST APIs, signed webhooks, and sandbox environments for Collect, Gateway, Payroll, and Treasury.
Definition
What is the Settlematic API?
The Settlematic API is a REST interface to create invoices, payment links, gateway checkout sessions, payroll runs, and treasury rules. It runs on testnet and mainnet with scoped API keys and signed webhooks.
Developer toolkit
- OpenAPI-documented REST endpoints
- Testnet and mainnet environments
- Webhook signature verification (HMAC-SHA256)
- Rate limit dashboards per API key
- Sandbox merchants for Gateway
- Scoped API keys (read, write, admin)
API modules
One authentication model across all modules. Start on testnet, promote to mainnet when ready.
Collect API
Invoices, payment links, clients, recurring schedules, reports
POST /api/invoicesGateway API
Merchants, checkout sessions, refunds, customers, webhooks
POST /api/gateway/sessionsPayroll API
Entities, team members, pay runs, schedules, expense claims
POST /api/payroll/runsTreasury API
Sweep rules, gas wallets, flows, destination management
POST /api/treasury/sweepsWhat developers get
Everything you need to integrate Collect, Gateway, Payroll, and Treasury — from sandboxes to signed webhooks.
OpenAPI REST
Documented endpoints for invoices, gateway sessions, payroll runs, and treasury rules — one auth model.
HMAC webhooks
Signed deliveries with retry, idempotency keys, and event logs your backend and finance team can audit.
Scoped API keys
Read, write, and admin scopes per key. Revoke instantly if a credential is exposed.
Testnet first
Full platform on testnet at no cost. Sandbox demo provisions sample data in 15 minutes.
Embeds
iframe checkout for payment links and gateway sessions inside your product UI.
Claude MCP
Agent tools for invoice creation, status checks, and workflow automation from MCP clients.
Sandbox
Testnet mirrors production behavior
Gateway sandbox merchants, testnet pay runs, and treasury sweeps behave like mainnet — without risking production funds. Promote integrations when your team signs off.
Open sandbox demo
Events
Webhook event catalog
Subscribe to invoice.paid, payment.confirmed, payrun.completed, and merchant lifecycle events. Delivery logs show payloads, retries, and response codes for debugging.
Integration catalogWebhook verification
Every webhook includes an HMAC-SHA256 signature in the X-Settlematic-Signature header. Verify before processing — sample code ships with your API keys dashboard.
Webhooks
Signed events you can trust
HMAC-SHA256 on every delivery.
OpenAPI specs ship with the product. Sign up for testnet access to explore endpoints interactively. Enterprise customers receive integration guides during onboarding.
Start invoicing, accepting, and paying in crypto
One non-custodial platform for your entire crypto money movement.