Skip to main content
By the end of this page you’ll have a live invoice with its own deposit address, and you’ll know how to hear about it when it gets paid. Before you start: a Liddie merchant account with 2FA enrolled, and the base URL https://api.liddie.io.
1

Create an API key

In the dashboard, go to Settings → API Keys and create a secret key with the payments:create and payments:read scopes.The raw key (lid_live_...) is shown exactly once. Store it in a secrets manager — if you lose it, you revoke it and mint a new one.
2

Create a payment

Tell Liddie the fiat amount you want to charge. It answers with the crypto quote, a unique deposit address, and a hosted invoice URL:
cURL
amount is fiat (USD by default) — “charge $75, payable in DOGE”. The response’s amount is the crypto quantity the payer must send. Every field is documented in Create a payment.
3

Show the payer the invoice

Redirect the payer to https://dash.liddie.io + the invoiceUrl from the response (invoiceUrl is a path such as /i/exampleslug1, and the hosted checkout is served from dash.liddie.io). The hosted checkout handles the currency display, QR code, quote refresh and status updates for you.Building your own checkout instead? Use the public payer endpoints.
4

Get notified when you're paid

Set your webhook URL in the dashboard and listen for payment.finished — the deposit was swept and the net credited, so that’s the “you got paid” event. (payment.confirming is the optional in-progress signal.) Check underpaid on the payload before fulfilling: a settled underpayment fires payment.finished too. Verify the HMAC signature on every delivery (the recipe), and double-check the state with Get a payment before releasing goods.
5

Know the lifecycle

A payment moves WAITING → CONFIRMING → CONFIRMED → FINISHED, or ends in PARTIALLY_PAID, EXPIRED, or CANCELLED. The full diagram: Payments overview.

​
If something goes wrong

Create a payment

Every request field and the full error table.

Webhooks & IPN

Signature verification, step by step.

Route map

Everything you can call, at a glance.