Payment ServicesPayFabric


Sana Commerce 9.2
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.

PayFabric provides a quick start guide to start integration with PayFabric.

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. 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.

For more information about devices, see PayFabric quick start guide.

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. Click "+ Add New Gateway", 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 filled in 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 the selected connector and processor support. Sana Commerce supports only Credit Card.

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.

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 4: To prevent customers from editing payment amount, currency, and order/invoice number, open the "script.txt" file stored in the "Utility Files" folder in the PayFabric add-on package, and copy the code from it to the "Custom.js" text box of the theme, and click "Save".

For more information, see "Themes".

Payment ServicesPayFabric