CDKeyMarkt
الكتالوج
API
المدونة
اعمل معنا
CDKeyMarkt API · v1

API بطاقات الهدايا للموزعين والمتاجر الإلكترونية. أكثر من 30,000 منتج من دون مخزون.

واجهة REST API واحدة لبطاقات الهدايا الرقمية وبطاقات الألعاب ومفاتيح الألعاب وعملات الألعاب. يعرض متجرك كتالوجنا بأسعار الجملة، ويدفع عميلك لك، ويستلم خادمك الكود في أقل من ثانية.

  • 30,000+منتج
  • 100+دولة
  • <1 ثمدة التسليم المعتادة
  • 2015في السوق منذ
curl -X POST https://api.cdkeymarkt.com/v1/orders \
  -H "Authorization: Bearer $CDKM_API_KEY" \
  -H "Idempotency-Key: shop-100482-1" \
  -d '{"reference":"SHOP-100482","currency":"EUR",
       "items":[{"product_id":"prd_8kq2v7m1","quantity":1,
                  "max_unit_price":"19.50"}]}'
201 Created
JSON
{
  "id": "ord_3n7xk2p9q4",
  "status": "completed",
  "total": "19.12",
  "items": [{
    "name": "Steam Wallet Gift Card 20 EUR",
    "codes": [{ "code": "8XK4Q-2M7PD-L9VRT" }]
  }]
}

من يستخدم واجهة API

المتاجر الإلكترونية

الموزعون

التطبيقات والبوتات

برامج الولاء والمكافآت

ماذا تفعل API بطاقات الهدايا

كل ما يحتاجه المتجر ليبيع أكوادًا رقمية ليست في مخزونه.

كتالوج بطاقات الهدايا

الطلبات

الشحن عبر معرّف اللاعب

Webhooks

Sandbox

الأرصدة

من الطلب إلى أول عملية شراء

يرافقك مدير حساب شخصي في كل خطوة.

  1. أرسل طلبًا

    املأ النموذج واجتز تحققًا قصيرًا من شركتك (KYB). نتعامل مع الشركات الموثّقة فقط.

  2. احصل على وصول Sandbox

    تتسلّم مفاتيح اختبار والتوثيق الكامل لواجهة API لمطوّريك.

  3. اربط واختبر

    جهّز الكتالوج والطلبات والـ Webhooks. نراجع طلباتك التجريبية معك.

  4. ابدأ التشغيل الفعلي

    نفعّل مفاتيح الإنتاج لعناوين IP خوادمك. اشحن رصيدك وابدأ البيع.

اطلب الوصول إلى API

API بطاقات الهدايا باختصار

REST وJSON عبر HTTPS، ومصادقة بالمفتاح، وترقيم صفحات بالمؤشر، وتوقيت UTC، والمبالغ كنصوص. يُقدَّم التوثيق الكامل للشركاء بعد الانضمام.

عنوان URL الأساسي
https://api.cdkeymarkt.com/v1
Sandbox
https://sandbox.api.cdkeymarkt.com/v1
المصادقة
Bearer ck_live_…
GET/productsالكتالوج مع الأسعار والمناطق والمخزون
GET/products/{id}منتج واحد: السعر والتوفر الآن
POST/ordersإنشاء طلب واستلام الأكواد
GET/orders/{id}حالة الطلب والأكواد المسلَّمة
POST/top-ups/validateالتحقق من معرّف اللاعب قبل الشحن
GET/balanceالرصيد لكل عملة
GET/transactionsكشف بالخصومات والمبالغ المستردة

ما الذي يمكنك بيعه

الأسئلة الشائعة

هل أحتاج إلى شراء مخزون لاستخدام API بطاقات الهدايا؟

لا. يعرض متجرك كتالوجنا ولا يرسل الطلب إلينا إلا بعد أن يدفع العميل. ويُخصم كل طلب من رصيدك المدفوع مسبقًا.

هل هذه API بطاقات هدايا للموزعين؟

نعم. صُممت الـ API للموزعين والمتاجر الإلكترونية والتطبيقات ومنصات المكافآت التي تبيع أو توزع بطاقات الهدايا الرقمية ومفاتيح الألعاب. تحصل على أسعار الجملة وكتالوج يضم أكثر من 30,000 منتج.

أين التوثيق الكامل لواجهة API؟

يُقدَّم التوثيق الكامل والوصول إلى Sandbox والمساعدة في الربط للشركاء بعد الانضمام والتحقق من الشركة.

ما المنصات التي يمكنني ربطها؟

أي شيء يمكنه إرسال طلبات HTTPS من خادم: WooCommerce وShopify وMagento والمتاجر الخاصة وبوتات تيليجرام والأدوات الداخلية.

ما سرعة وصول الكود؟

عادةً ضمن الاستجابة لطلبك مباشرةً، في أقل من ثانية. وإن استغرق التسليم وقتًا أطول، يكتمل الطلب في الخلفية ونرسل Webhook.

هل توجد بيئة Sandbox؟

نعم. فيها رصيد تجريبي ونسخة من الكتالوج ومنتجات خاصة لاختبار التأخير والتسليم الجزئي ونفاد المخزون.

هل يمكنني الشراء بالجملة دون API؟

نعم. في بوابة B2B الكتالوج نفسه والأسعار نفسها. هناك تطلب الكمية يدويًا وتنزّل الأكواد.