Developers Community

Dear Valued Merchant,   We are pleased to share recent updates and enhancements to our platform to benefit your business:   (النسخة العربية متوفرة في أسفل المنشور)   Merchant Dashboard Enhancements: EGYPT: Shahry (Tru) Receipt: Showing Shahry (Tru) payment method transaction receipt details within the transaction Payment method tab in the dashboard: EGYPT: Souhoola-Merchant Dashboard Transaction View Updates: Showing Souhoola payment method transaction Issure Name, RRN, and Acquirer ref details within the transaction Payment method tab section in the dashboard: . EGYPT: FORSA - Create Refund Callback API: To notify the merchant dashboard if a transaction is refunded from the FORSA side, this transaction will show as follows: API Enhancements: EGYPT: Halan transaction details return within the callback/IPN: You will receive all Halan transaction details within the transaction response payload callback and IPN. For example: "halan_data":{ "status":200, "Message":"success", "data":{ "transactionReceipt":{ "id":{ "value":"h-XXX" }, "date":{ "value":17XXXXXXXX }, "time":{ "value":17381XXXXXX }, "type":{ "value":"Purchase" }, "status":{ "value":"Successed" }, "totalAmount":{ "value":"2099.4" }, "oldTotalAmount":{ "value":"0" }, "downPayment":{ "value":"0" }, "financingAmount":{ "value":"2099.4" }, "admissionFees":{ "value":"0" }, "requiredAmount":{ "value":"0" }, "installmentPeriod":{ "value":36 }, "monthlyInstallment":{ "value":"163" } }, "issuedLoans":[ { "applicationId":"67XXXXXXXXXX" } ], "transactionStatus":{ "code":1000, "message":"success" } }, "transactionReceipt":{ "id":{}, "date":{}, "time":{}, "type":{}, "status":{}, "totalAmount":{}, "oldTotalAmount":{}, "downPayment":{}, "financingAmount":{}, "admissionFees":{}, "requiredAmount":{}, "installmentPeriod":{}, "monthlyInstallment":{} }, "transactionStatus":{} } Add support for pagination in the invoice search API: By adding the additional field of 'page' to the request JSON payload, for example: { "profile_id": "47157", "created_date_from": "01/11/2024", "created_date_to": "01/11/2024", "page": 2 } This field is only accepted if the search request is considered the following:                 - Provide the date range only created_date_from, and created_date_to (so no cart ID/customer ref etc).                 - The date range is a single day (so from and to date must be the same).                 - The value for page can be between 1 and 20.                 - If no page value is provided, then 1 is assumed For any other request, the field is ignored, and paging is not enabled. If paging was enabled, then the response will contain details of the available data set: "pager":{ "page":2, "pageSize":500, "pageItems":500, "totalItems":1317 } page   Current page number pageSize Max number of items per page  pageItems Actual number of items on this page totalItems  Total items available over all pages In this example, the total available items is 1317, so page 1 would have 500, page 2 would have 500, and page 3 would have 317. Pages 4 onwards would not exist.  Include Payment Channel in IPN, Callback and transaction inquiry response: Your transaction channel will return within the callback/IPN response, like "Payment Page, Mobile SDK, WooCommerce, etc": "paymentChannel": "WooCommerce", Include 3DS details in the IPN/Callback URL: Also, your transaction 3DSecure details will return within the callback/IPN response, check the example below: "threeDSDetails":{ "responseLevel":2, "responseStatus":4, "enrolled":"Y", "paResStatus":"Y", "eci":"05", "cavv":"", "ucaf":"AAIBBzGClQAAAA+ggXXXXXXXX", "threeDSVersion":"2.2.0" }, Plugin(s) Enhancements: Add TRU (Shahry) payment method on the following plugins: Magento 2: version 3.25.0 PrestaShop : version 3.17.0 OpenCart : version 4.16.0 OpenCart 3.x : version 3.22.0 To learn more, visit our Support Portal.  Share feedback directly with the Community or reach out to us at [email protected].    We look forward to being of continued service. PayTabs Team _____________________________________________________________________________   عميلنا العزيز   تحية طيبة من بيتابس و بعد .تسرنا مشاركتكم التحديثات الأخيرة على منصة بيتابس للتجار، نأمل بأن تساعدك هذه التحديثات في تنمية التجارة الإلكترونية الخاصة بك  :تحسينات لوحة تحكم التاجر إظهار بيانات أيصال دفع شهري (ترو): عرض تفاصيل إيصال معاملة طريقة الدفع شاهري (ترو) ضمن قسم علامة تبويب طريقة الدفع في لوحة التحكم. سهولة: عرض لوحة تحكم التاجر لمزيد من تفاصيل الخاصه بالمعاملة: عرض تفاصيل طريقة دفع سهولة، مثل اسم البنك المُصدر، (الرقم التعريفي للبنك)، والمرجع الخص بالبنك المستحوذ، ضمن قسم علامة تبويب طريقة الدفع في لوحة التحكم. فرصة : إنشاء تنبيه فوري لمعلومات استرداد المعاملة: إخطار لوحة تحكم التاجر إذا تم استرداد معاملة من جانب فرصة، وستظهر هذه المعاملة على النحو التالي التحسينات على نقاط الربط البرمجية استقبال تفاصيل معاملة "حالا"  ضمن بيانت إرسال معلومات المعاملة/إشعارات الدفع الفورية: سوف تتلقى جميع تفاصيل معاملة "حالا" ضمن بيانات إرسال معلومات المعاملة/إشعارات الدفع الفورية, على سبيل المثال: "halan_data":{ "status":200, "Message":"success", "data":{ "transactionReceipt":{ "id":{ "value":"h-XXX" }, "date":{ "value":17XXXXXXXX }, "time":{ "value":17381XXXXXX }, "type":{ "value":"Purchase" }, "status":{ "value":"Successed" }, "totalAmount":{ "value":"2099.4" }, "oldTotalAmount":{ "value":"0" }, "downPayment":{ "value":"0" }, "financingAmount":{ "value":"2099.4" }, "admissionFees":{ "value":"0" }, "requiredAmount":{ "value":"0" }, "installmentPeriod":{ "value":36 }, "monthlyInstallment":{ "value":"163" } }, "issuedLoans":[ { "applicationId":"67XXXXXXXXXX" } ], "transactionStatus":{ "code":1000, "message":"success" } }, "transactionReceipt":{ "id":{}, "date":{}, "time":{}, "type":{}, "status":{}, "totalAmount":{}, "oldTotalAmount":{}, "downPayment":{}, "financingAmount":{}, "admissionFees":{}, "requiredAmount":{}, "installmentPeriod":{}, "monthlyInstallment":{} }, "transactionStatus":{} } تمت أضفه ترقيم لنتائج البحث عن الفواتير من خلال نقاط الربط البرمجية: عن طريق إضافة الحقل التالي إلى طلب نقطة الربط ، كالتالي: { "profile_id": "47157", "created_date_from": "01/11/2024", "created_date_to": "01/11/2024", "page": 2 } يعمل هذا الحقل فقط اذا توفرت الشروط التالية: - تقديم النطاق الزمني فقط created_date_from و created_date_to (بدون CartID / و مرجع العميل، وما إلى ذلك). - يجب أن يكون النطاق الزمني يومًا واحدًا (يجب أن تكون تواريخ البداية والنهاية متطابقة). - يجب أن تكون قيمة الحقل "page" بين 1 و 20. - إذا لم يتم تقديم قيمة "page"، فسيتم افتراض ان القيمة 1. - في حاله عدم توافر هذه الشروط، سوف يتم تجاهل الحقل "page" ولن يتم تمكين الترقيم. إذا تم تمكين خاصية الترقيم، فسيتضمن الاستجابة تفاصيل مجموعة البيانات التالية: "pager":{ "page":2, "pageSize":500, "pageItems":500, "totalItems":1317 } رقم الصفحة الحالي page الحد الأقصى لعدد العناصر لكل صفحة pageSize عدد العناصر الفعلي في هذه الصفحة pageItems إجمالي العناصر المتاحة عبر جميع الصفحات totalItems في هذا المثال، إجمالي العناصر المتاحة هو 1317، لذا سيكون لدى الصفحة رقم (1) 500 عنصر، والصفحة 2 سيكون لديها 500 عنصر، والصفحة 3 سيكون لديها 317 عنصر. الصفحات 4 فصاعدًا لن تكون موجودة. تضمين قناة دفع  المعامله ضمن بيانت إرسال معلومات المعاملة/إشعارات الدفع الفورية:  وفقا لذلك، ستعود قناة الربط التي تمت من خلالها المعاملة ضمن بيانات إرسال معلومات المعاملة/إشعارات الدفع الفورية، مثل 'Payment Page، Mobile SDK، WooCommerce، إلخ.'   "paymentChannel": "WooCommerce", تضمين تفاصيل المصادقة ضمن بيانت إرسال معلومات المعاملة/إشعارات الدفع الفورية: إشعارات الدفع الفورية سوف تضمن تفاصيل المصادقة الخاصة بكل معاملة، كما هو موضح بالمثال أدناه: "threeDSDetails":{ "responseLevel":2, "responseStatus":4, "enrolled":"Y", "paResStatus":"Y", "eci":"05", "cavv":"", "ucaf":"AAIBBzGClQAAAA+ggXXXXXXXX", "threeDSVersion":"2.2.0" }, التحسينات الخاصة بملحقات/إضافات الدمج تمت أضفه طريقة دفع (شهري) إلى ملاحق/إضافات الربط /الدمج التالية: Magento 2: إصدار  3.25.0  OpenCart: إصدار   4.16.0  OpenCart 3.x: إصدار 3.22.0  PrestaShop: إصدار 3.17.0   لمعرفة المزيد، يمكنكم زيارة صفحة الحلول التقنية ، وفي حال كانت لديكم أي اسئلة او مقترحات، يمكنكم مشاركتها مباشرة عبر صفحة منتدى المطورين ، أو عبر التواصل المباشر مع فريق خدمة العملاء على الإيميل  [email protected] نشكركم على اختيار بيتابس كبوابة الدفع الموثوقة لكم، ونتطلع للإستمرار بخدمتكم دمتم بخير    فريق بيتابس