Developers Community

Dear Valued Merchant, Ramadan Kareem.  We are pleased to share recent updates and enhancements to our platform to benefit your business:   (النسخة العربية متوفرة في أسفل المنشور)   Display of the New Saudi Riyal Currency Symbol instead of the SAR currency code on the payment page: Merchant Dashboard Enhancements: Increase profile limits: The profile limits under a merchant account have been increased from 16 to 32. APIs Enhancements: -Add new response field "payment_date" in invoice search results: If you use the search endpoint to search for invoices transactions you will receive the transaction included the payment_date paramter: { "invoices": [ { "invoice_id": 315XXX, "invoice_type": "Standard", "customer_name": "First Last", "merchant_name": "PayTabs", "profile_name": "PayTabs", "creation_date": "2025-02-12T11:25:42Z", "invoice_ref": "", "modified_on": "2025-02-12T11:25:42Z", "status": "paid", "currency": "SAR, "amount": "1350", "description": "", "transaction_reference": "TST2506202025319", "transaction_date": "2025-03-03T11:39:35Z" } } KNet payment method enhancement: Support Arabic-based redirect: If the merchant creates the payment page in Arabic or the customer switch it to Arabic, the KNet payment method will be displayed in Arabic also. Transaction completion screen enhancement: If the merchant sets a return URL, after the customer completes the KNet payment, a countdown will display before the redirection. New React native package version 6.6.26): This upgrade is to support the latest version of PayTabs Native Android and iOS SDKs To learn more, visit our Support Portal.  Share feedback directly with the Community or reach out to us at customercare@paytabs.com.    We look forward to being of continued service. PayTabs Team _____________________________________________________________________________   عميلنا العزيز   تحية طيبة من بيتابس و بعد .تسرنا مشاركتكم التحديثات الأخيرة على منصة بيتابس للتجار، نأمل بأن تساعدك هذه التحديثات في تنمية التجارة الإلكترونية الخاصة بك  إظهار رمز الريال الجديد بدلاً من SAR في صفحة الدفع: :تحسينات لوحة تحكم التاجر : (Profiles) زيادة حد عدد الملفات الشخصية-   تمت الآن زيادة حدود الملف الشخصي ضمن حساب التاجر من 16 إلى 32 ملفًا شخصيًا   :تحسينات على نقاط الربط البرمجية :( "payment_date" )إضافة حقل مدرج جديد ضمن رد النقطة البرمجية في نتائج بحث الفاتورة -    إذا كنت تستخدم نقاط الربط البرمجية للبحث عن معاملات الفواتير،  فسوف تتلقى نتائج بحث  المعاملة شاملة تاريخ المعامله ( payment_date)  { "invoices": [ { "invoice_id": 315XXX, "invoice_type": "Standard", "customer_name": "First Last", "merchant_name": "PayTabs", "profile_name": "PayTabs", "creation_date": "2025-02-12T11:25:42Z", "invoice_ref": "", "modified_on": "2025-02-12T11:25:42Z", "status": "paid", "currency": "SAR, "amount": "1350", "description": "", "transaction_reference": "TST2506202025319", "transaction_date": "2025-03-03T11:39:35Z" } }  (KNet) تحسين طريقة الدفع -دعم إعادة التوجيه باللغة العربية: إذا قام التاجر بإنشاء صفحة الدفع باللغة العربية أو قام العميل بتحويلها إلى اللغة العربية، سيتم عرض طريقة الدفع KNet باللغة العربية أيضًا. :تحسين شاشة إكمال المعاملة- سيتم عرض عد التنازلي قبل إعادة  التوجيه , بعد أن يكمل العميل دفع كى نت  ,  (ReturnURL) إذا قام التاجر بتعيين عنوان رابط توجيه العميل  إصدار جديد من حزمة(React native 6.6.26 ): يهدف هذا التحديث إلى دعم أحدث إصدار من PayTabs Native Android وiOS SDKs  لمعرفة المزيد، يمكنكم زيارة صفحة الحلول التقنية ، وفي حال كانت لديكم أي اسئلة او مقترحات، يمكنكم مشاركتها مباشرة عبر صفحة منتدى المطورين ، أو عبر التواصل المباشر مع فريق خدمة العملاء على الإيميل  customercare@paytabs.com نشكركم على اختيار بيتابس كبوابة الدفع الموثوقة لكم، ونتطلع للإستمرار بخدمتكم دمتم بخير    فريق بيتابس

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 customercare@paytabs.com.    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   لمعرفة المزيد، يمكنكم زيارة صفحة الحلول التقنية ، وفي حال كانت لديكم أي اسئلة او مقترحات، يمكنكم مشاركتها مباشرة عبر صفحة منتدى المطورين ، أو عبر التواصل المباشر مع فريق خدمة العملاء على الإيميل  customercare@paytabs.com نشكركم على اختيار بيتابس كبوابة الدفع الموثوقة لكم، ونتطلع للإستمرار بخدمتكم دمتم بخير    فريق بيتابس