ولائيولائي
ফিরে যান

للمطورين

লয়্যালটি আপনার POS-এর সঙ্গে যুক্ত করুন

পেমেন্টের সময় পয়েন্ট যোগ ও গ্রাহক নিবন্ধনের জন্য পরিষ্কার REST API এবং signed 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

Signed webhooks

প্রতিটি loyalty action-এর তাৎক্ষণিক event, automatic retry সহ।

03

ডুপ্লিকেট-নিরাপদ

Idempotency Key নেটওয়ার্ক সমস্যায় দুইবার পয়েন্ট দেওয়া ঠেকায়।

04

রেডি ইন্টিগ্রেশন

Foodics, Odoo, Shopify, WooCommerce এবং custom cashier systems।

05

টেস্ট পরিবেশ

প্রোডাকশনের আগে flow পরীক্ষা করার জন্য test keys।

06

পরিষ্কার সীমা

প্রকাশিত usage limits এবং enterprise 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