PayTabs plugins make the integration with the PayTabs payment gateway very easy by providing a ready-made and easy-to-install plugin that enables you to be ready and go with a few steps, to get you up and running with your business. 

In this article, we will walk you through how to control what will be the order status on your system if it's failed in the payment phase (declined/error/not a successful payment). We highly recommend that you check our "3.1 Magento Plugin| Magento's Orders Workflow" solution article first to understand the business/logic this configuration option relay on. To manage this configuration option, kindly follow the below steps:


1. From your Magento admin panel, Navigate to the Stores menu, then select the Configurations menu item.

2. In the "Configurations" page, and from the “Sales” tab, select the "Payment Methods" menu item. 

3. Expand the preferred payment method from the provided list by PayTabs of the supported payment methods available.

4. Finally, choose which of the below order statuses you want the orders that have been not passed the payment phase successfully to be marked with, after they are failed on the payment phase (declined/error/not a successful payment) as shown below:


 If you choose to check on the "Use system value" checkbox, then the "Canceled" will be selected as a value for this configuration option.

  • Pending
    This status means that your store will hold the order with no invoices and shipments to be submitted.

  • Processing
    When the state of new orders is set to ‘Processing’, the "Automatically Invoice All Items" option becomes available in the Magento configuration. Invoices are not created automatically for orders placed by using Gift Card, Store Credit, Reward Points, or other offline payment methods.

  • Suspected Fraud
    Sometimes orders paid via Paytabs are flagged to be Suspected Fraud. This means that this order will not have an invoice to be issued and the confirmation email will not be sent as well.

  • Complete
    This status means that the order is successfully created, paid, and shipped to the customer as well.

  • Closed
    This status indicates that an order was assigned to a credit memo and the customer has received the refunded amount as well.

  • Canceled
    This status is assigned/used manually by the Magento store/website admin or, for some payment gateways such as PayTabs, when the customer does not pay within the specified time.

  • On Hold
    This status can only be assigned manually. You can put any order on hold.

Be very careful when you change the Default option. Once you change it, you change the normal flow of the Order into the Magento system, you may encounter some consequences based on the new value you set 

⌂ To get familiar with the whole process and the other steps, kindly navigate to our "The Magento Plugin Integration Manual" solution article. 

 And to navigate to the previous step in the integration process "Step 1 - Setup and activate the integration method" click here.

 And to get familiar with the rest of the steps regarding the current step "Step 2 - Configure the integration method" click here

⇨ Or you can navigate to the next step in the integration process "Step 3 - Initiating the payment" kindly click here.