سجل التغييرات

إصدار الـ API جزء من الرابط (/v1). نضيف إلى v1 حقولًا ونقاط نهاية وأنواع أحداث ورموز أخطاء دون إشعار مسبق، لذا اجعل تكاملك يتجاهل الحقول وأنواع الأحداث التي لا يعرفها. التغييرات غير المتوافقة لن تصدر إلا في إصدار جديد.

1 نوفمبر 2026

• سعر واحد لكل تاجر: لكل عملية دفع رسوم واحدة، هي رسوم تيرا باي في commission (نسبتك المئوية زائد مبلغ ثابت)، في كل الحسابات ولكل وسائل الدفع. وأصبحت net دائمًا amount − commission، ويتبعها رصيدك وإيداعاتك. راجع الرسوم والمبلغ الصافي.
• حُذف الحقل fee من كائن الدفع (الـ API والـ Webhooks وملف CSV المصدَّر من لوحة التحكم). تكاليف المعالجة مشمولة في رسوم تيرا باي. إن كان تكاملك يقرأ fee فاستخدم commission بدلًا منه.
• رسائل الفواتير والإيصالات: الفواتير التي تُنشأ من لوحة التحكم مع بريد العميل تُرسل إليه مع زر ادفع الآن، ويصل إلى العميل إيصال عند نجاح دفعة تتضمن بريده (مرة واحدة لكل دفعة، ويمكن إيقافه من الإعدادات ← إعدادات النشاط). تُرسل الرسائل باسم نشاطك وبلغة الدفعة language. راجع رسائل الفواتير والإيصالات.
• send_email في POST /v1/payments: القيمة true ترسل الدفعة إلى customer.email كفاتورة. لا تُرسل مدفوعات الـ API بالبريد افتراضيًا.

29 أكتوبر 2026

• وسائل الدفع حسب الحساب: دليل جديد، وسائل الدفع وحسابك، يشرح ما يعتمد على حسابك: الحسابات الإماراتية تقبل card وapple_pay وgoogle_pay، أما كي-نت ومدى وبنفت وSTC Pay فمتاحة في الحسابات التي تدعمها.
• الوسائل غير المدعومة: يعيد POST /v1/payments مع payment_method لا يدعمها حسابك الخطأ 422 validation_error مع details.fields.payment_method = "unsupported".
• المبالغ ذات المنازل الثلاث: في بعض الحسابات يجب أن تنتهي مبالغ KWD وBHD وOMR وJOD بصفر (422 validation_error، details.fields.amount = "unsupported")، في المدفوعات وروابط الدفع.
• صفحة الدفع: في الحسابات الإماراتية يُفتح 3-D Secure في نافذة على صفحة الدفع، ويُعرض Apple Pay وGoogle Pay في النموذج نفسه. وتعرض مدفوعات Apple Pay وGoogle Pay قيمة payment_method apple_pay / google_pay مع brand وlast4 لبطاقة المحفظة.
• الاعتراضات: في الحسابات الإماراتية يتلقى المالكون رسالة عند الاعتراض على دفعة، وتعرض الاستردادات ← الاعتراضات في لوحة التحكم حالة كل اعتراض (needs_response وunder_review وwon وlost وclosed) وآخر موعد للرد. راجع الاعتراضات.

28 أكتوبر 2026

• صفحة الدفع: يفتح checkout_url الآن صفحة الدفع في تيرا باي مع حقول بطاقة آمنة مضمّنة فيها، في وضعي الاختبار والحي. ولا يغادرها العميل إلا لخطوة 3-D Secure لدى بنكه أو لصفحة دفع بنكية مثل كي-نت. راجع صفحة الدفع المستضافة.
• إعادة المحاولة: يمكن دفع العملية failed أو canceled مجددًا عبر checkout_url نفسه حتى expires_at. راجع المدفوعات.
• الوضع الحي يتطلب HTTPS: في الوضع الحي يجب أن يستخدم return_url وروابط نقاط الـ Webhook البروتوكول https://، وإلا فشل الطلب بالخطأ 422 validation_error. راجع وضع الاختبار والوضع الحي.
• حدود معدل الطلبات: تسمح /v1 بـ 1,200 طلب في الدقيقة لكل مفتاح سري، مع ترويسات x-ratelimit-* والخطأ 429 rate_limited. راجع حدود معدل الطلبات.
• روابط الدفع أحادية الاستخدام تُحجز أثناء دفع العميل، فلا يمكن دفعها مرتين أبدًا. راجع الروابط أحادية الاستخدام.
• التوثيق: قائمة تحقق قبل الإطلاق في صفحة وضع الاختبار والوضع الحي.

أكتوبر 2026: الإصدار v1

أول إصدار عام لواجهة تيرا باي.

• المدفوعات: POST /v1/payments وGET /v1/payments/:id وGET /v1/payments مع صفحة الدفع المستضافة (checkout_url) وإعادة التوجيه (return_url?payment_id=…&status=…).
• وسائل الدفع: كي-نت ومدى وVisa وMastercard وAmerican Express وApple Pay وGoogle Pay وبنفت وSTC Pay.
• العملات: KWD وBHD وOMR وJOD (3 منازل عشرية) وSAR وAED وQAR وEGP (منزلتان)، بالوحدات الصغرى.
• الاسترداد: استرداد كامل وجزئي عبر POST /v1/payments/:id/refunds، إضافة إلى GET /v1/refunds.
• روابط الدفع: إنشاء الروابط القابلة للمشاركة وعرضها وجلبها وتعطيلها.
• الإيداعات: GET /v1/deposits يعرض التحويلات إلى حسابك البنكي.
• الـ Webhooks: نقاط نهاية تُدار من الـ API أو لوحة التحكم، وتواقيع Teyra-Signature بخوارزمية HMAC-SHA256، وسبعة أنواع من الأحداث، وإعادة محاولة تلقائية على مدى 45 ساعة تقريبًا.
• المنصة: وضعا الاختبار والحي، وIdempotency-Key مع كل طلب POST، وترقيم الصفحات بالمؤشر، وأخطاء JSON موحّدة.
• التوثيق: أدلة بالعربية والإنجليزية، ومرجع API تفاعلي مولَّد من ملف OpenAPI.

القادم

• نشر أرقام بطاقات الاختبار لكل وسيلة دفع.
• تطبيق تيرا باي لـ Shopify وإضافة WooCommerce.