Webhook Verification Key
Webhook Verification Key
### Order Editing
Please note that order details editing (as order lines, customer details, etc.) will be reflected in Shopify Dashboard only and will not updated for the payment on Tabby Merchant Dashboard, Customer Portal and Settlements.
### Order Lines
Shopify doesn't share order data via the Payment App and Shopify does not share any order line data for non-product order lines, e.g. VAT/taxes, discounts, surcharges, tip, etc. Tabby orders will have necessary Order Lines data after Webhook installation.
### Order Tagging
Tabby Payment App cannot currently set tags on a Shopify order. You can use the Shopify Flow app (free and available on all Shopify plans) which can set order tags within a flow for Tabby orders.
### Payment Method Presentation
The Tabby payment method name is provided with English and Arabic translations out of the box.
To reorder or hide payment methods in Shopify checkout, use Shopify's checkout customizations powered by Payment Customization Functions — either via a Functions-powered app from the Shopify App Store, or via Checkout Blocks (Shopify Plus). The legacy checkout scripts (Script Editor) stopped executing on June 30, 2026 and can no longer be used for payment method customization.
Customizations of the Tabby payment method presentation (logo, footer text) are currently supported only for Shopify Plus merchants. If you implement your own custom snippet, notify your Tabby account manager so we can keep your integration in sync with upcoming changes.
### Domain Filtering
Payment App uses a different hosted payment page URL: `checkout.tabby.ai` (UAE, Kuwait) or `checkout.tabby.sa` (KSA).
Merchants that filter this domain in Google Analytics will need to update their GA configurations accordingly.
### Market Limitation
Tabby Payment App accept orders only for the billing addresses in the markets of KSA, UAE, Kuwait. Customers for non-supported regions based on the order's currency are shown an error message on page load that the Tabby order cannot be processed.
We recommend limiting Tabby's visibility at checkout to the countries where your store works with Tabby — has a signed contract and an active integration. You can hide Tabby for other countries using Shopify's checkout customizations (available on all Shopify plans), so customers from non-supported regions don't see the error message.
### Multi-Currency Processing and Currency Conversion
Tabby processes payments in the following currencies: SAR (SR), AED (Dhs), and KWD (KD), which must correspond to the customer's billing address. Tabby Payment App is compatible with all Shopify stores, regardless of their base currency.
If the store’s base currency differs from the customer’s billing currency, currency conversion will be applied, and the converted amount will be displayed at Tabby checkout. Customer transactions and merchant settlements will be processed in the customer’s billing currency.
Currency conversion is also applied between supported currencies if the store’s base currency differs from the customer’s billing currency.
Please note that to enable conversion, the “Enable Multi-Currency Processing” option must be selected in the Tabby settings.
### Inventory Lock Limitation and Inventory Stock Check
When a customer places an order with an alternative payment integration, such as Tabby Payment App, Shopify redirects to the payment method but does not lock the order's product inventory and thus stock inventory cannot be guaranteed.
However, Tabby can check inventory immediately after payment is completed but before the order is created in Shopify. If an item goes out of stock during the payment process, the funds will be refunded to the customer, and the Shopify order will not be created.
To enable this functionality, please turn on the **Check Inventory Stock** feature in Tabby settings in your Shopify admin panel.
Note that this feature only works when the following settings are applied to your products in Shopify settings:
* **Inventory tracking** is enabled
* **Continue selling when out of stock** setting is disabled
### Additional Request of the Phone Number
Shopify may not share the customer's phone number with payment integrations at checkout (for example, when email is required instead of phone). Tabby fetches the phone number via the Shopify Webhooks set up during the Installation Steps. If the webhooks are not set up, Tabby will ask the customer to enter the phone number again within our Hosted Payment Page.
### Checkout Error Limitation
*"There was an issue processing your payment. Try again or use a different payment method." –* this message can happen for tech/authorization reasons only. The most common reason (for new integrations) is that the API keys haven't been populated fully. You can check the API credentials at merchant.tabby.ai (KSA: merchant.tabby.sa). Also, this message appears if country in shipping or billing address is different from country (countries) that your Tabby account is signed for. It can also appear if your integration hasn't been set up on the Tabby side yet — in this case contact Tabby partner support at `partner@tabby.ai` / `partner@tabby.sa`.
### Redirection for Background Pre-Scoring Rejection
Tabby now redirects the customers to our internal rejection screens where we explain the reason and advise how to avoid this rejection if possible. Customers may see the general rejection explanation (can't be avoided), too high cart total and too low cart total rejections (can be skipped by adjusting the cart total).
### The Amount Paid by the Customer to Tabby Doesn't Match the Shopify Order Total
If customers update a related, but different Shopify session separately from the Shopify session used to place the Tabby order, the order totals between the Shopify and Tabby orders may not match, but the amount "Paid by customer" for the Shopify order should always match the Tabby order total. While not ideal, this is working as expected and designed. Care should be taken to only fulfill order line items paid for by the customer.
### Feedback and Support
If additional support is needed, email `partner@tabby.ai` / `partner@tabby.sa` (please include your Shopify store name and add your Account Manager in CC) for specific Tabby support.
Customer Tabby Support available at `help@tabby.ai` / `help@tabby.sa`
[https://community.shopify.com](https://community.shopify.com) is a good place for Shopify questions, support, and feedback, in addition to [https://help.shopify.com/](https://help.shopify.com/)