We have the same configurations for all Magento 2 versions.
1. Get started¶
2. API Configuration¶
Version: The extension version.
Api environment: Sandbox for testing and Production for Live.
Merchant Token: Your merchant token provided by Tamara.
Notification Token: Your notification token provided by Tamara.
Phone verified: Select Yes if you verify customers phone numbers from your side and do not require Tamara to carry out phone number verification.
Enable Webhook: If you enable this setting, Tamara will use the webhook to handle the Order Declined and Order Expired. After a certain time, the order that has been declined or expired from Tamara will be updated to the status that is set in “Order status when checkout is cancelled” and “Order status when checkout is failure” option.
Webhook Id: Your webhook ID, this label will be showed after you enable webhook and save the configuration.
3. Basic configuration¶
(3.1) Debug: Allow the module to write logs to file. It is useful to trace if a problem occurs.
(3.2) Enable trigger to Tamara: This option allows you to automatically trigger Capture, Cancel and Refund order to Tamara when you perform corresponding action in Magento or not. If disabled, you need to integrate with our APIs directly or use our Partner Portal to do so.
(3.3) Enabled whitelist function for Tamara: The whitelist function allows only emails in a specific email list to be able to use Tamara. You can add New Email by going to Customers > Tamara Whitelist. This option is useful when you want to test and don’t want actual customers to use Tamara.
(3.4) Send email to customer when: This option allows the extension to send an email to the customer when you authorise / cancel / refund an order.
**(3.5) The shipping countries that are allowed to use Tamara. If you want to allow all available countries to use, select the “All Allowed Countries” option. If you want to choose specific countries, select the “Specific countries” option and pick the country you wish to allow in the field below.
(3.6) Payment From Specific Countries: Allowed country to use Tamara.
(3.7) Block Web View: Enable it if you want to block the Tamara checkout from native mobile app.
(3.8) Checkout success url: This option allows you to customize the url that you want redirect to after the customer’s successful payment with Tamara.
(3.9) Checkout cancel url: This option allows you to customize the url that you want redirect to after the customer’s canceled payment on Tamara.
(3.10) Checkout failure url: This option allows you to customize the url that you want redirect to after the customer’s failed payment with Tamara.
(3.11) Use magento checkout success page: Select Yes if you want to use the default checkout success page on Magento. If No, we will use Tamara success page.
(3.12) Enable Tamara widget: Enable if you want to show the Tamara widget in the product details page.
(3.13) Exclude Tamara on product IDs: Hide Tamara widget on these products, also hide Tamara payment on checkout page if your cart has any of these items. Each ID is separated by a comma ",".
(3.14) Auto generate invoice: This option allows the extension to automatically generate the invoice after order authorisation or order capture.
(3.15) Display over/under limit amount warning: If select yes, the extension will display a warning message at the checkout page if the cart total amount is over / under Tamara limits for payment,.Otherwise, hide unavailable payment methods.
4. Whitelist accounts¶
5. Payment types¶
Title: The title of payment method on the checkout page
Sort order: To adjust the display order of this method on the checkout page
6. Order status mapping¶
Order status after order created in Magento: The status that you want to set for the order when it is created
Order status when checkout is a success (after the redirect): The status that you want to set for the order if the payment is successful with Tamara
Order status when checkout is a failure: The status that you want to set for the order if the payment is failed with Tamara
Order status when checkout is canceled: The status that you want to set for the order if the customer cancels or leave while making the payment with Tamara
Order status when order is authorised: The status that you want to set for the order after it is authorised
Here are the statuses corresponding to Tamara:
||Payment is approved by Tamara and the customer has finished the checkout flow then redirect back to the merchant site|
||Payment is declined by Tamara|
||Payment is canceled by the customer from Tamara checkout|
||Tamara sends an authorization callback and gets confirmation from the merchant (Magento) successfully.|
7. Capture status mapping¶
Which order status do you want to Tamara capture API?: The status that you want extension call API to capture order
8. Console Configuration¶
Which order status do you want to Tamara refund API?: The order status that you want the extension use to refund order while it’s scanned in console [Ref. Console command]