مقدمة
تيرا باي واجهة برمجية واحدة لقبول كي-نت ومدى والبطاقات وApple Pay وغيرها من وسائل الدفع الخليجية عبر صفحة دفع مستضافة.
تتيح لك تيرا باي (Teyra Pay) قبول المدفوعات الإلكترونية في دول الخليج من خلال تكامل واحد. تنشئ عملية الدفع من خادمك، وتوجّه العميل إلى صفحة دفع آمنة تستضيفها تيرا باي، ثم تستلم إشعار Webhook موقّعًا عند اكتمال الدفع. لا تتعامل أبدًا مع بيانات البطاقات.
ماذا يمكنك أن تبني
- دفع إلكتروني لموقعك أو تطبيقك عبر صفحة الدفع المستضافة.
- روابط دفع ترسلها عبر واتساب أو الرسائل النصية أو البريد الإلكتروني دون أي برمجة. راجع روابط الدفع.
- إضافات المتاجر لمنصتي Shopify وWooCommerce.
- الاسترداد الكامل أو الجزئي من الـ API أو من لوحة التحكم. راجع الاسترداد.
وسائل الدفع
| الوسيلة | قيمة payment_method | الأسواق المعتادة |
|---|---|---|
| كي-نت (KNET) | knet | الكويت |
| مدى | mada | السعودية |
| Visa وMastercard وAmerican Express | card | جميع الأسواق |
| Apple Pay | apple_pay | جميع الأسواق |
| Google Pay | google_pay | جميع الأسواق |
| بنفت (Benefit) | benefit | البحرين |
| STC Pay | stc_pay | السعودية |
تعتمد الوسائل التي تظهر للعميل على العملة وجهاز العميل وحسابك: البطاقات وApple Pay وGoogle Pay متاحة في كل الحسابات، أما كي-نت ومدى وبنفت وSTC Pay فمتاحة في الحسابات التي تدعمها. راجع وسائل الدفع وحسابك.
كيف يعمل
أنشئ عملية دفع
يستدعي خادمك POST /v1/payments بالمبلغ بالوحدات الصغرى والعملة وreturn_url. تعيد تيرا باي كائن Payment يحتوي على checkout_url.
وجّه العميل
أرسل متصفح العميل إلى checkout_url. يختار العميل وسيلة الدفع ويدفع في صفحة تستضيفها تيرا باي، بالعربية أو الإنجليزية.
يعود العميل
يعود العميل إلى return_url ومعه payment_id وstatus في رابط الصفحة.
تحقّق ونفّذ الطلب
تأكد من النتيجة عبر GET /v1/payments/:id أو عبر إشعار payment.succeeded بعد التحقق من توقيعه، ثم نفّذ الطلب.
الـ API في لمحة
| الموضوع | التفاصيل |
|---|---|
| العنوان الأساسي | https://api.teyra.co |
| الإصدار | /v1 في كل مسار |
| المصادقة | Authorization: Bearer sk_test_… أو sk_live_…. راجع المصادقة |
| الصيغة | JSON في الطلب والاستجابة، وأسماء الحقول بصيغة snake_case |
| المبالغ | أعداد صحيحة بالوحدات الصغرى مع رمز العملة (ISO) |
| المعرّفات | نصوص ببادئة: pay_ وre_ وplink_ وevt_ وwe_ وdep_ |
| الأوقات | صيغة ISO 8601 بتوقيت UTC، مثل 2026-10-28T14:07:00.000Z |
| إعادة المحاولة بأمان | ترويسة Idempotency-Key مع كل طلب POST. راجع منع التكرار |
| القوائم | ترقيم الصفحات بالمؤشر. راجع ترقيم الصفحات |