Configure Tamara Settings on Salesforce¶
1. Main settings¶
Go to Business Manager > Merchant Tools > Site Preferences > Custom Site Preferences >Tamara Payment
and update the Cartridge Custom Site Preferences accordingly
| ID | Description | Sandbox | Production |
|---|---|---|---|
| tamaraEnablement | Enable the Tamara payment on storefront | Yes | Yes |
| tamaraEndPoint | Tamara API endpoint | https://api-sandbox.tamara.co/ | https://api.tamara.co/ |
| tamaraAPIToken | API Token is used in every single request to Tamara API. | Will be provided by our partner team | Will be provided by our partner team after completing testing with sandbox |
| tamaraSupportedCountries | The list of Country Codes supports by Tamara | AE,SA,KW | AE,SA,KW |
| tamaraPriorityPDPWidget | Display Priority of Tamara Widget on the Product Details Page | PAY_BY_INSTALMENTS | PAY_BY_INSTALMENTS |
| tamaraNumberOfInstallments | Numbe of instalments on the widget | 3 | 3 |
| tamaraWebhookEvents | Web Hook Events | ["order_approved", "order_declined", "order_authorised", "order_canceled", "order_captured", "order_refunded","order_expired"] | ["order_approved", "order_declined", "order_authorised", "order_canceled", "order_captured", "order_refunded","order_expired"] |
2. Services Credentials¶
Go to Administration > Operations > Services > Service Credentials
You will see all the services we are using.
Note that the User and password for each service should be empty.
3. Order expiry time¶
Set Order Failure Time by heading over to Merchant Tools > Site Preferences > Order -> Find the Auto-Fail Orders setting, set it to 30 minutes.
4. Webhooks¶
Register the webhook notifications you wish to receive to keep up to date with the status of your orders.
This process requires 1-time setting by running the controller TamaraHook-Register. This will call a Tamara web service to subscribe to all the events mentioned in the “WebHook Events”
After finishing the setup with all steps above, please run TamaraHook-Register controller, you will receive the result with the “webhook_id” as shown in the image.
Record this ID somewhere in order to update the webhook event in the future if you wish, following the document here.
You are also able to manage the webhook from our partner portal
5. Enable cartridge¶
Enable cartridge in Business Manager by heading over to Administration > Organization > Roles > select.
For adding different types of widgets to your website, please head over to our widgets page.