Magento Plugin Configuration

After the plugin is installed you will need to do some required configuration for the checkout option to become available. Below we outline which configuration is required, and which other configurations you can change.

Go to the configuration section for Amwal Payments

In your Magento admin panel, navigate to Stores > Configuration > Sales > Payment methods. On this page, under the “Other payment methods” section, you will find the configuration section for Amwal Payments.

Generic configuration

1. Enable the plugin
To enable the plugin please change the “Enabled” setting to “Yes”

Merchant settings

2. Merchant ID
Here you will fill in your Merchant ID. You can find or create your Merchant ID in your Merchant account on https://merchant.sa.amwal.tech/.

You can also use the “Verify Merchant ID” button to make sure your merchant ID is entered correctly.

3. Secret Key
This is a secret key that is used to authenticate the plugin with the Amwal Payments API. Please do not share this key with anyone. If you believe your key has been compromised, please contact Amwal Payments support immediately.

4. Installment URL
This is the URL to the installment options page. This page will be displayed to the customer when they click the “Installments” button on the checkout page. Please ensure that this URL is correct and that the page is accessible to your customers.

Visual settings

1. Title
This is the title of the payment method that is shown during the regular checkout process.

2. Dark Mode
Changes the appearance of the checkout button. When set to “Off” the button will be black with white text, and when set to “On” the button will be white with black text. Adjust this to fit the look and feel of your store.

3. Style CSS
This is where you can add custom CSS to style the checkout button. This is useful if you want to change the size, color, or font of the button. You can also use this to hide the button on certain pages. For example, if you want to hide the button on the cart page, you can add the following CSS:

.amwal-express-checkout-button.product-detail-page,  .box-tocart .action.tocart{
    width: 70%;
}

@media (max-width: 767px) {
    .amwal-express-checkout-button.product-detail-page {
        width: unset;
    }

    .catalog-product-view .hydrated center {
        text-align: right;
        background: #fff;
        position: fixed;
        bottom: 0;
        left: 0;
        z-index: 9999;
        width: 100%;
    }
    .button-text {
        padding-left: 0 !important;
    }
    .products-grid .product-item-actions .amwal-express-checkout-button {
        width: 90% !important;
    }
   
   .ribbon~.button-text{
        font-size: 10px !important;
    }
}

.product-item-actions .actions-primary, .actions-secondary{
  width: 100%;
}

4. Discount Ribbon
When set to “On” a ribbon will be displayed on the checkout button to indicate that a discount is available. When set to “Off” the ribbon will not be displayed. Adjust this to fit the look and feel of your store.

Order settings

1. Order confirmed status
The status that should be assigned to the order in Magento after the payment has been successfully processed.
2. Create customer on order creation
This option allows you to create a new customer account in Magento when a new order is created in Magento.
3. Send email when order status changed to customer
This option allows you to send an email to the customer when the order status is changed in Magento by the cron job or the Amwal order details button.
4. Send email when order status changed to admin
This option allows you to send an email to the admin when the order status is changed in Magento by the cron job.

Country Specific Settings

1. Payment from Applicable Countries
Indicated if the payment method should be available for all countries, or a selected list of countries. To limit the allowed countries set this option to “Specific countries”

2. Payment from Specific Countries
If the “Payment from Applicable Countries” is set to “Specific countries” you can select the countries that should be allowed to use the Amwal checkout option here.

1. Debug mode
   If enabled this option will log additional information during the checkout process. Should be disabled in production environments and only be activated for debugging purposes.

Cron Job Settings

This Cron Job plays a crucial role in maintaining order processing efficiency. It is specifically designed to periodically check and update the status of orders that are currently marked with a 'Pending Payment' status. By running at regular intervals, this automated process ensures timely updates, reducing manual intervention and helping maintain accurate and up-to-date order status information in the system.

Frequency
Cron Job Frequency is 1 hours.

Jobs
1. Update Pending Orders
This job retrieves all orders that are currently marked with a 'Pending Payment' status from -1 hour. It then checks the status of these orders with the payment gateway and updates the order status accordingly.

Developer Settings

1. Debug mode
If enabled this option will log additional information during the checkout process. Should be disabled in production environments and only be activated for debugging purposes.

2. Report errors to Sentry
If enabled, this option will report any errors that occur during the checkout process to Amwal sentry.