Payment ServicesPayFabric


Sana Commerce 9.3
Your connector

Set up PayFabric Account

When the PayFabric add-on is installed inside Sana, it must be configured in the PayFabric Web admin portal and in Sana Admin. To set up the PayFabric payment acceptance engine and payment methods, you must have the PayFabric (Version 3) test/live account.

Once you have created the PayFabric account, it must be configured with one of the PayFabric supported payment gateways. See the list of payment gateways supported by PayFabric and information that is required to configure the payment gateway.

Step 1: Sign in to the PayFabric portal with your activated account and create at least one device to identify your web store.

To populate a new Device ID, navigate to: Configuration > Settings > Dev Central > Devices Management. On the "Device Management" page, click "Generate". Enter "Device Name" and "Password" to create a device.

Settings Value
Device Name One device corresponds to one application. You can enter any name.
Password This password is used by Sana to create a security token. You will need to enter it in the PayFabric configuration section in Sana Admin.

You can set up the PayFabric settings for each device, like available card types and transaction options. For more information, see "PayFabric Settings". Sana Commerce does not use such PayFabric settings as "Post URL" and "Return URL".

Step 2: Merchant's payment gateway account information must be encrypted and saved in PayFabric before any payment transaction can be successfully submitted. On the PayFabric portal, go to: Configuration > Settings > Gateway Account Profiles. Click "+ New Gateway Account", and fill in all the necessary fields in the form.

The first 4 fields are required by PayFabric. All other fields are required by the selected payment gateway (connector). Thus, the fields you must fill in can differ depending on the selected payment gateway.

Field Description
Name/Setup ID Enter gateway account profile name to identify the record. It must be unique.
Connector Select the payment gateway supported by PayFabric.
Processor Select the corresponding bank processor which belongs to the selected payment gateway. Filtered by Connector.
Card Class Credit Card or ECheck. These are tender types that are supported by the selected connector and processor.

See "Gateway Account Profiles" for description of the gateway specific fields.

Step 3: To fit the overall style of a Sana web store, you can apply custom CSS to the PayFabric payment page. On the PayFabric portal, go to: Configuration > Settings > Dev Central > Themes. On the "Themes" page, click "Create New +". Enter the name of the theme, for example "Sana Commerce". You will also need to enter this theme name in the payment method settings in Sana Admin.

Step 4: Download the PayFabric Utility Files from the "Add-ons" page on the Sana Community website. Only registered Sana partners can download these files. Open the "theme.txt" file stored in the "Utility Files" folder in the PayFabric add-on package, and copy the code from it to the "Custom.css" text box of the theme, and click "Save".

Step 5: To prevent customers from editing payment amount, currency, and order/invoice number, open the "script.txt" file stored in the "Utility Files" folder, you downloaded in the previous step and copy the code from it to the "Custom.js" text box of the theme, and click "Save".

Additionally, you can enable and disable the options like "Pay Later", "Batch", "History Cards". To do this, click "Set Params" to see the options.

For more information, see "Themes".

Payment ServicesPayFabric