Decal Documentation
Accept stablecoin payments and run loyalty programs with Decal.
Decal is a modern payments and loyalty platform for merchants. These docs cover everything you need to accept payments, manage orders, and integrate with your existing systems.
Who these docs are for
These docs are for developers integrating Decal into their applications — e-commerce sites, point-of-sale systems, mobile apps, or any backend that needs to create orders and collect payments.
Where to start
New to Decal? Start with Getting Started for a 5-minute path from zero to your first test payment.
Exploring the platform? Read the Concepts section to understand how orders, checkout sessions, and payment links fit together.
Ready to build? Jump into the API Reference for endpoint details, or the Guides section for end-to-end integration walkthroughs.
What's in each section
Concepts — foundational explanations of how Decal works:
- Orders — what an order is, lifecycle, statuses, and amounts
- Checkout Sessions — how sessions are created, settings hierarchy, and session management
- Payment Routing — wallet types, default routing, and per-order / per-location overrides
- Smart Payments — how Decal selects the optimal stablecoins and wallets to fund each payment
- Smart Balance — the unified spendable balance customers see across all connected wallets
Guides — end-to-end integration walkthroughs:
- Web Integration Guide — accept payments on your website with hosted checkout
- POS Integration Guide — integrate Decal payments into a point-of-sale system
API Reference — complete endpoint documentation:
- Orders API — manage and query orders
- Checkout Sessions API — create hosted payment experiences
- Events — event catalog, payload schemas, and delivery channels
- Errors — error response shape and status codes
- Shared types — addresses, pagination, metadata