For merchant CTOs, engineering leads, and developers integrating qardon.com checkout into their POS, website, or mobile app. Full production-grade SDK + REST API documentation lands with Phase 2 GA. This page is a forward-looking technical preview — useful for scoping the integration ahead of time.
Drop-in JS snippet for any e-commerce platform. One line in your HTML, one configured button. Launches first in Phase 2 build sequence — no platform certification gate.
Native Shopify App Store listing. Install, enable, live. Goes through Shopify Partners certification before public availability.
Native WordPress / WooCommerce plugin. Published to the WordPress Plugin Directory. WooCommerce-certified.
Direct REST API with OAuth 2.0 + HMAC signing. For custom integrations, headless commerce, and merchants with proprietary platforms.
Native iOS SDK published to CocoaPods + Swift Package Manager. For merchants with native iOS POS apps.
Native Android SDK published to Maven Central. For merchants with native Android POS apps.
Add the qardon.com checkout JS to your page (typically in <head>):
<!-- Add to your checkout page --> <script src="https://js.qardon.com/v1/checkout.js"></script> <!-- Render the button at checkout --> <button class="qardon-checkout-btn" data-qardon-merchant-id="YOUR_MERCHANT_ID" data-amount="5000.00" data-currency="USD" data-order-id="ORDER-12345" data-installments="12,24,36,48"> Pay in installments — 0% interest via qardon.com </button>
When the customer clicks, our JS opens a hosted modal that handles: identity verification, creditworthiness check, installment plan selection, agreement signing, payment method capture. On successful approval, we POST a webhook to your configured endpoint with the transaction ID and approved installment schedule. Settlement to your merchant account begins per your agreed schedule.
OAuth 2.0 client credentials. HMAC-signed payloads. Idempotency keys on every mutating request. Sandbox + production environments. Full OpenAPI 3.1 spec on Phase 2 GA.
| Method | Endpoint | Purpose | Status |
|---|---|---|---|
POST |
/api/v1/merchant/transactions |
Create a new transaction. Returns transaction ID + hosted checkout URL. | v1 |
GET |
/api/v1/merchant/transactions/:id |
Retrieve transaction status, approval result, installment schedule, settlement record. | v1 |
POST |
/api/v1/merchant/refunds |
Initiate a refund (partial or full). Cancels remaining installments, refunds prior payments, claws back paid settlement. | v1 |
GET |
/api/v1/merchant/settlements |
Settlement reports with date-range filters. Returns per-transaction settlement details + reconciliation. | v1 |
POST |
/api/v1/merchant/disputes |
Respond to a customer-initiated dispute. Submit evidence + response within 30-day window. | v1 |
POST |
/api/v1/merchant/milestones |
Construction / multi-stage merchants: submit completion proof for a milestone, trigger next-tranche settlement. | v1.1 |
GET |
/api/v1/merchant/dashboard/metrics |
Real-time metrics for embedding in merchant's own dashboard. Approval rate, volume, settlement totals. | v1.1 |
curl -X POST https://api.qardon.com/api/v1/merchant/transactions \ -H "Authorization: Bearer ${QARDON_API_KEY}" \ -H "X-Qardon-Signature: ${HMAC_SIGNATURE}" \ -H "X-Qardon-Idempotency-Key: ${UUID}" \ -H "Content-Type: application/json" \ -d '{ "merchant_id": "merch_abc123", "amount_cents": 500000, "currency": "USD", "order_id": "ORDER-12345", "customer": { "email": "[email protected]", "first_name": "Jane", "last_name": "Doe", "billing_address": { ... } }, "installment_options": [12, 24, 36, 48], "category": "furniture", "metadata": { "sku": "couch-large", "store_id": "store-7" }, "webhook_url": "https://yourstore.example/qardon-webhook" }'
Response includes a hosted checkout URL for redirect, or — for fully embedded flows — a transaction token to inject into your in-page Qardon Element. Approval result + final installment schedule arrives via the configured webhook.
/transactions endpoint, receiving a hosted checkout URL or in-page transaction token.You'll receive: full OpenAPI 3.1 spec, SDK release notes, sandbox credentials, integration guides per platform, technical support contact during your integration. First 100 developer waitlist members get priority sandbox access.