اربط Reconfirm في خطوات بسيطة.

نظرة عامة

1. اطلب من فريق Reconfirm ربط متجرك أو نظام الشحن.
2. أرسل كل طلب عبر API أو استيراد CSV.
3. تابع قرارات العملاء في لوحة التحكم، أو استقبل إشعار Webhook موقّعًا.

المسار الأساسي: /api/v1

المصادقة

يوفر فريق Reconfirm مفتاحًا خاصًا بشركتك. احتفظ به على خادمك.

Authorization: Bearer YOUR_API_KEY

بدء التوصيل

POST /api/v1/orders يستقبل طلبًا ويحفظه ويُدرج رسالة التأكيد الأولى في قائمة الإرسال بشكل موثوق.

{
  "external_order_id": "4821",
  "customer_name": "Sara Ahmed",
  "customer_phone": "+201001234567",
  "shipping": {
    "address": "12 Nile Street",
    "city": "Cairo",
    "country": "EG"
  },
  "items": [
    {
      "name": "Cotton T-shirt",
      "quantity": 1,
      "unit_price": "250.00"
    }
  ],
  "total": "250.00",
  "currency": "EGP"
}

عند تكرار معرّف الطلب الخارجي نفسه، يُعاد الطلب الموجود. إذا اختلفت بيانات العميل، تُعاد الحالة 409.

ارفع ملفات CSV بترميز UTF-8 بحجم لا يتجاوز 20 ميبيبايت إلى POST /api/v1/importsالأعمدة المطلوبة: external_order_id,customer_name,customer_phone.

ردود العملاء

يمكن لفريقك إعداد Webhook موقّع لأحداث order.decision_recordedتتضمن الإشعارات معرّف حدث ثابتًا وتوقيعًا في X-Reconfirm-Signature توقيع HMAC-SHA256. أكّد الاستلام باستجابة 2xx، وتجنّب التكرار باستخدام معرّف الحدث.

استعلم عن طلب باستخدام GET /api/v1/orders/{id}يبقى أول قرار صالح يُسجّل عبر أزرار القالب ثابتًا.

الحالات

نتابع تقدم مسار التنفيذ وتسليم الرسائل بشكل منفصل عن قرار العميل.

الأخطاء

401 بيانات اعتماد غير صالحة · 409 تعارض في الطلب · 422 بيانات غير صالحة · 503 غير متاح مؤقتًا.