ولائيولائي
واپس

للمطورين

وفاداری کو POS سے جوڑیں

واضح REST API اور دستخط شدہ 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 API

اپنے سسٹم سے پوائنٹس شامل کریں، استعمال کروائیں اور گاہک رجسٹر کریں۔

02

دستخط شدہ Webhooks

ہر وفاداری ایکشن کے فوری ایونٹس، خودکار دوبارہ کوشش کے ساتھ۔

03

تکرار سے محفوظ

Idempotency Key نیٹ ورک رکنے پر پوائنٹس دوبارہ دینے سے بچاتی ہے۔

04

تیار انٹیگریشنز

Foodics، Odoo، Shopify، WooCommerce اور کسٹم کیشیئر سسٹمز۔

05

ٹیسٹ ماحول

پروڈکشن سے پہلے فلو ٹیسٹ کرنے کے لیے تجرباتی کیز۔

06

واضح حدود

اعلانیہ استعمال حدود اور اداروں کے لیے SLA۔

نقاط النهاية

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

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