انتقل إلى المحتوى
Teyra Pay
التبديل إلى الإنجليزية: English

المطوّرون

واجهة برمجية تفهمها في جلسة واحدة

أنشئ عملية دفع، ووجّه عميلك إلى رابط checkout_url، ثم تحقّق من النتيجة عبر إشعار Webhook موقّع. بيانات JSON واضحة، ومعرّفات ذات بادئات مميِّزة، ومبالغ بأعداد صحيحة.

اطّلع على الوثائق التقنية(يُفتح في علامة تبويب جديدة)أنشئ حسابًا
POST /v1/paymentsمثال على طلب عبر الواجهة البرمجية يُنشئ عملية دفع.
curl https://api.teyra.co/v1/payments \
  -H "Authorization: Bearer sk_test_…" \
  -H "Idempotency-Key: order-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 13500,
    "currency": "KWD",
    "reference": "1042",
    "language": "ar",
    "return_url": "https://shop.example.com/thanks"
  }'

استقبل عملية دفع في ثلاث خطوات

  1. 1

    أنشئ عملية الدفع

    أرسل المبلغ والعملة ورابط العودة من خادمك باستخدام مفتاحك السري.

  2. 2

    وجّه العميل إلى صفحة الدفع

    حوّله إلى checkout_url الوارد في الاستجابة، ليدفع هناك بالعربية أو الإنجليزية.

  3. 3

    تحقّق من النتيجة

    انتظر إشعار payment.succeeded أو استعلم عن عملية الدفع، ولا تعتمد على إعادة التوجيه وحدها.

  • مفاتيح للاختبار وأخرى للوضع المباشر

    طوّر باستخدام مفاتيح الاختبار قبل اعتماد حسابك، ثم انتقل إلى المفاتيح المباشرة.

  • إعادة المحاولة بأمان

    أعد إرسال أي طلب POST دون قلق؛ فتكرار مفتاح Idempotency-Key نفسه لا يُنشئ عملية دفع ثانية.

  • إشعارات Webhook موقّعة

    تُوقَّع الأحداث بخوارزمية HMAC-SHA256، ويُعاد إرسالها على فترات متباعدة حتى 8 محاولات.

  • مبالغ دقيقة

    أعداد صحيحة بأصغر وحدة للعملة: 12500 تعني 12.500 د.ك، دون أخطاء تقريب.

موارد الواجهة البرمجية

جميع القوائم مقسّمة إلى صفحات باستخدام مؤشّر (cursor)، ولكل خطأ رمز ثابت.

المدفوعات
إنشاء عمليات الدفع والاستعلام عنها وعرضها.
الاسترداد
استرداد كامل أو جزئي مع متابعة الحالة.
روابط الدفع
إنشاء الروابط القابلة للمشاركة وعرضها وإيقافها.
الإيداعات
عرض المبالغ المودَعة في حسابك البنكي.
نقاط استقبال Webhook
اشترك في الأحداث لتصل إلى خادمك.

أحداث Webhook

يُوقَّع كل حدث بالمفتاح السري لنقطة الاستقبال، ويصل التوقيع في الترويسة Teyra-Signature.

  • payment.succeeded
  • payment.failed
  • payment.canceled
  • payment.expired
  • refund.succeeded
  • refund.failed
  • deposit.paid

مكتبات الخادم (SDK)

نعمل حاليًا على مكتبتين رسميتين للتعامل مع واجهة Teyra Pay البرمجية بلغتَي Node.js وPHP، وتعرض الوثائق التقنية حالتهما وطريقة استخدامهما.

وكل ما تحتاجه في الوثائق التقنية

الأدلة والمرجع الكامل للواجهة البرمجية وخطوات إعداد WooCommerce وShopify متاحة على docs.teyra.co.

اطّلع على الوثائق التقنية(يُفتح في علامة تبويب جديدة)

جاهز للبدء؟

أنشئ حسابك لتحصل على مفاتيح الاختبار، ثم اتبع الوثائق التقنية.

أنشئ حسابًاتواصل مع فريق المبيعات