Lydian Developer Documentation
Lydian lets you accept cryptocurrency payments at checkout. Your customer pays in a supported asset (for example USDT on Ethereum), Lydian confirms the payment on-chain, and your merchant account is settled — without you handling wallets, gas, or exchange rates yourself.
How a payment works
Every Lydian payment follows the same high-level flow:
- Create a Session — your backend opens a payment Session for a specific amount.
- Collect the payment — the customer completes payment through Lydian checkout (hosted or embedded), choosing their asset and network.
- Confirm on-chain — Lydian creates and tracks a Transaction and confirms it on the blockchain.
- Get notified — you confirm the final status by polling the API or receiving a webhook.
For a deeper look, see How Lydian Payments Work and Sessions & Transactions.
Ways to integrate
- Hosted Checkout (recommended) — your backend creates a Session and sends the customer to the Lydian-hosted checkout URL returned as
qrData. The least code to get started. See Accept Your First Payment. - Embedded Web Checkout — drop the
<lydian-checkout>element onto your own page with the Web SDK to keep customers on your site. See Web Checkout and the Web SDK. - Work directly with the API — every endpoint, request, and response is documented in the API Reference.
Not sure which to pick? Start with Choose Your Integration.
Get set up
Create your merchant and generate keys in the Lydian Merchant Dashboard, then follow the Quickstart to take your first payment in the sandbox. See Authentication & Environments for keys and base URLs.