اربط برنامج الولاء مع الكاشير ونقاط البيع
ربط برنامج الولاء مع نظام الكاشير يخلّي الختم جزءًا من الفاتورة نفسها: نظامك يرسل رمز العميل وقيمة الفاتورة، وكرم يختم بطاقته أو يحسب نقاطه تلقائيًا — بلا خطوة إضافية على الموظف.
POST https://api.krm.sa/api/v1/transactions
Authorization: Bearer kr_live_…
Idempotency-Key: INV-8891
{
"code": "482019337",
"action": "stamp",
"invoice_amount": 24.00,
"pos_reference": "INV-8891"
}ثلاث خطوات من الفاتورة إلى بطاقة العميل
- أنشئ مفتاحًا
من لوحة كرم: الإعدادات ← نقاط البيع. مفتاح تجربة للتطوير، ومفتاح إنتاج للتشغيل.
- نظامك يرسل الفاتورة
عند إغلاق الفاتورة يرسل نظام الكاشير رمز العميل (أو جواله) وقيمة الفاتورة إلى كرم.
- البطاقة تتحدّث وحدها
نسجّل العملية حسب قواعد بطاقتك — ختم أو نقاط أو رصيد — وتتحدّث بطاقة العميل في محفظته فورًا.
كل أنواع البطاقات، من نظام الكاشير نفسه
كل عملية تمرّ على قواعد بطاقتك نفسها كما لو ختمها الكاشير بيده: فترة التهدئة، وسقف أختام العملية، وصلاحية المكافأة.
- ختم مع كل فاتورة
عملية «ختم» تلقائية، مع عدد الأختام إن طلب العميل أكثر من صنف — في حدود سقف بطاقتك.
- نقاط وكاش باك من قيمة الفاتورة
ترسل قيمة الفاتورة، فتُحسب النقاط أو نسبة الكاش باك حسب قواعد البطاقة.
- استبدال المكافأة
حين تكتمل البطاقة، يستبدل الكاشير المكافأة من نظامه نفسه بلا شاشة ثانية.
- رصيد واشتراكات
إضافة رصيد لبطاقة الإهداء، واستهلاك استخدام من بطاقة الاشتراك.
- قراءة بطاقات العميل
برمز العميل: اسمه، وعدد زياراته، وعدّاد كل بطاقة، وهل مكافأته جاهزة — لتعرضها على شاشة الكاشير.
- خطّافات (Webhooks)
إشعار لنظامك عند كل عملية، وعند جاهزية مكافأة، وعند تسجيل عميل جديد، وعند استبدال — موقّعة بـ HMAC.
واجهة موثّقة وآمنة
- وصف كامل بصيغة OpenAPI 3.1 يُولَّد من الشيفرة نفسها، فلا يتأخر عن الواجهة.
- مفتاح تجربة (kr_test_) ينفّذ المسار كاملًا ثم يتراجع — للتطوير بلا أثر على العملاء.
- ترويسة Idempotency-Key تمنع منح العملية مرتين عند إعادة الطلب.
- خطّافات موقّعة بـ HMAC-SHA256 مع طابع زمني، تُعاد عند الفشل.
- رسائل خطأ عربية جاهزة للعرض على شاشة الكاشير.
- صفحة الربط التقنية في لوحة كرمOpenAPI
أسئلة عن ربط الكاشير ونقاط البيع
تفاصيل البطاقات في بطاقات الولاء الرقمية، وما يناسب المطاعم في برنامج ولاء للمطاعم.
الربط والواجهة البرمجية API في الباقة الاحترافية. وفي كل الباقات يختم الكاشير من تطبيق الكاشير على الجوال أو من نقطة البيع على الويب، بلا أي ربط.
الواجهة البرمجية مفتوحة الآن ويصلح ربطها بأي نظام كاشير يقدر يرسل طلبًا عند إغلاق الفاتورة. أما التكاملات الجاهزة مع أنظمة بعينها فقيد التطوير — أخبرنا بنظامك لنضعه في الأولوية.
نعم. مفتاح التجربة ينفّذ الطلب كاملًا ثم يتراجع عنه، فلا يبقى أثر على أي بطاقة، والرد يوضّح أنه تجربة. وبعد ما يشتغل كل شيء تنتقل لمفتاح الإنتاج.
أرسل مع كل عملية مفتاح Idempotency-Key ثابتًا: لو تكرّر الطلب نفسه بعد نجاحه لا تُمنح العملية مرتين، ويرجع الرد نفسه مع إشارة أنه تكرار.