Dukkan Developer Platform
Build for every Dukkan store.
Apps, themes and integrations for the merchants of Syria and the region. OAuth 2.1, signed webhooks, sandbox stores with real data — and a marketplace that pays.
Free to build. Publish after review.
curl "https://dukkan.one/platform-api/v1/orders?limit=5" \
-H "Authorization: Bearer $DUKKAN_ACCESS_TOKEN"{
"data": [{
"order_number": "1042",
"status": "placed",
"payment_status": "unpaid",
"total": { "amount_minor": 275000, "currency": "SYP", "decimals": 0 }
}],
"next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wOC0xOCJ9"
}Platform
Real commerce, real APIs.
OAuth 2.1 with least privilege
Per-store consent, PKCE, and scopes that never widen silently.
Signed webhooks
HMAC-SHA256 on every delivery, full logs, controlled retries, at-least-once.
Regional commerce
Cash on delivery, Syrian pounds, inventory, refunds and fulfillment — modelled the way merchants actually work.
Themes and CLI
Liquid themes with npx @dukkan.one/theme-cli — init, check, push, live preview.
From idea to marketplace
Four steps. No waiting.
Create and configure
Scopes, redirects and development credentials
Test privately
OAuth, webhooks and realistic commerce flows
Submit for review
A frozen version and an Arabic + English listing
Publish
Available to Dukkan merchants
npx @dukkan.one/theme-cli theme init my-theme
npx @dukkan.one/theme-cli login
npx @dukkan.one/theme-cli theme dev
✓ pushed draft v3 · preview https://dukkan.one/stores/my-sandbox?__preview=TOKENDocumentation
Start reading.
- Build an appRegister, get an OAuth token and make your first call in 15 minutes.
- OAuth & scopesThe authorization flow, PKCE, and the scope every operation needs.
- Webhooks & signaturesThe envelope, signature verification, retries and ordering.
- Money, COD & refundsMinor units, the cash-on-delivery lifecycle and refunds.
- Build a themeFrom an empty folder to a live preview on your sandbox store.
- CLI referencelogin, init, check, push and dev — every command and flag.
Trust
Build immediately. Publish after review.
Verified developers build and test privately — no waiting on Dukkan. Publishing to the marketplace needs one approved, immutable submission.
- Immutable versions
- Every submission is a frozen snapshot of your app.
- Sandbox stores
- Realistic data and private installs before anything ships.
- Endpoint checks
- Private, loopback and CGNAT webhook targets are refused.
- Bilingual by design
- Arabic and English listings are required.
Ready to build?
Create your first app in minutes. Publish when you are ready.