ولائيولائي
رجوع

للمطورين

اربط الولاء بنقطة البيع

واجهة REST واضحة و Webhooks موقّعة — أضف النقاط وسجّل العملاء عند الدفع.

أنشئ حساباً للواجهة البرمجيةالتكاملات الجاهزة
curl -X POST https://api.walaay.sa/v1/stores/{storeId}/transactions/earn \
  -H "Authorization: Bearer $WALAAY_TOKEN" \
  -H "Idempotency-Key: order_10231" \
  -H "Content-Type: application/json" \
  -d '{
    "cardPublicCode": "WL-RST-4821",
    "purchaseAmountHalalas": 4500
  }'

القدرات

واجهة مبنية للاستخدام في الإنتاج

01

واجهة REST عامة

أضف واستبدل النقاط وسجّل العملاء من نظامك.

02

Webhooks موقّعة

أحداث فورية لكل إجراء ولاء مع إعادة محاولة تلقائية.

03

آمنة ضد التكرار

Idempotency Key يمنع منح النقاط مرتين عند انقطاع الشبكة.

04

تكاملات جاهزة

Foodics و Odoo و Shopify و WooCommerce وأنظمة كاشير مخصّصة.

05

بيئة اختبار

مفاتيح تجريبية لاختبار التدفق قبل الإنتاج.

06

حدود واضحة

حدود استخدام معلنة واتفاقيات مستوى خدمة للمؤسسات.

نقاط النهاية

أهم مسارات الواجهة

POST/v1/auth/loginتسجيل الدخول والحصول على رمز الوصول
GET/v1/stores/mineمتاجر الحساب الحالي
POST/v1/stores/:storeId/cards/issueإصدار بطاقة لعميل
POST/v1/stores/:storeId/transactions/earnإضافة نقاط أو ختم
POST/v1/stores/:storeId/transactions/redeemاستبدال مكافأة
GET/v1/cards/:publicCodeقراءة بطاقة برمزها العام
GET/v1/stores/:storeId/statsإحصاءات المتجر

Webhooks

أحداث فورية موقّعة

card.issuedعند إصدار بطاقة جديدة لعميل
transaction.earnedعند إضافة نقاط أو ختم
transaction.redeemedعند استبدال مكافأة
reward.unlockedعند اكتمال هدف الأختام أو النقاط
subscription.updatedعند تغيير باقة المتجر
كل طلب موقّع بترويسة X-Walaay-Signature (HMAC-SHA256)، وإعادة المحاولة تتم تلقائياً بتباعد متزايد. استخدم Idempotency-Key لمنع تكرار منح النقاط.

التكاملات

يعمل مع الأنظمة التي تستخدمها

FoodicsOdooShopifyWooCommerceSallaZidCustom POSZapier