Setup

Payment Methods



In Sana Admin click: Setup > Ordering & checkout > Payment methods.

Under the Payment methods tab you can setup payment providers and create payment methods.

Payment provider is a service that allows to accept credit card payments securely online through your webstore.

Sana Commerce connects to different payment providers across the world:

  • Authorize.Net
  • ChargeLogic (available as add-on)
  • DIBS
  • Docdata
  • Ingenico
  • PayPal Express Checkout
  • PayPal Payflow Link
  • PostFinance (available as add-on)
  • WorldPay (available as add-on)
  • KBC Paypage (available as add-on)
  • Adyen (available as add-on)
  • Buckaroo (available as add-on)
  • Sage Pay (available as add-on)
  • CyberSource (available as add-on)
  • Wirecard (available as add-on)

You should have an account (test / live) of the payment provider that you will use with all necessary data, configure and enable the payment provider in Sana Admin and create payment methods that are supported by your payment provider.

Configure payment provider

Step 1: Under the Payment methods tab click Configuration.

Step 2: Find the necessary payment provider and expand its configuration area.

Step 3: Choose the appropriate payment integration mode.

There are two modes: test and live. Test mode allows to simulate the payment process as if it is a real payment and helps to make sure that everything will behave the same way when you go live. Live mode implies that a customer makes a real purchase using already configured payment provider and methods.

Step 4: Configure the payment provider by entering the payment provider specific settings of the test/ live account.

The settings of the payment provider should be configured depending on which mode is set.

Below are the links to the chapters that contain the detailed information about each payment provider:

When payment provider is configured you can create and configure the payment methods.

Create payment methods

To create payment methods you should have a configured payment provider.

Step 1: In Sana Admin click: Setup > Ordering & checkout > Payment methods.

Step 2: Click New item to create a payment method.

Configuration of the payment methods is almost the same for any payment provider; the only difference is in the Payment provider field and payment provider specific settings.

The table below provides the description of the general payment method fields:

Field Description
Name Enter the payment method name.
Enabled Enable/disable payment method. Payment methods can be also enabled/disabled in the payment methods list.
Image Select the payment method icon. It is shown in the webstore in the list of available payment methods near its name.
Description You can add a description to the payment method. Payment method description is shown in the Sana web store on the 'Payment information' checkout step, where a customer can select the payment method he or she wants to pay the order.
Selected by default If this checkbox is activated, this payment method will be selected in the webstore by default.
Payment provider Select your payment provider. Some of the payment providers contain the additional settings that may appear.
Payment costs Configure the payment costs per currency. Select the currency and enter amount including and excluding tax. Depending on the customer setting in your ERP system (Prices including VAT/TAX) the appropriate amount will be used.

     Starting from Sana 9.2.1, if payment cost is 0, the text "Free" will be shown, meaning that no extra fee is charged for online payment. The color of the text is green by default, but you can change it in the web store theme settings.

Availability per country Select for which countries the payment method should be available.

The table below provides the description of the payment provider specific settings:

Settings Description
Authorize.Net
x_method The method of payment for the transaction: CC (credit card) or ECHECK (electronic check).
Default: CC
x_type The type of credit card transaction.

Values: AUTH_CAPTURE (default), AUTH_ONLY, CAPTURE_ONLY, CREDIT, PRIOR_AUTH_CAPTURE, VOID

For more information about credit card transaction types supported by Authorize.Net, see 'Transaction Types'.

Docdata
profile The payment profile that is set in the Docdata backoffice.
default_pm The default payment method which should be selected automatically on the payment page of Docdata.
Docdata (old API)
profile The payment profile that is set in the Docdata backoffice.
Ingenico
PM The proper 'PM' values can be found in the Ogone documentation. You should log in the Ogone backoffice and then click: Support > Integration & user manuals > Technical Guides > Parameter Cookbook. Find the 'PM' field name in the table and in the 'Details' column you can see the links to the list of the 'Brand' and 'PM' values for the test and production environments.
BRAND The 'Brand' values can be seen in the Ogone backoffice on the payment methods page: Configuration > Payment methods.
ACQUIRER An acquirer is a financial institution that processes payments from certain credit and debit card brands. When you add a payment method in the Ogone backoffice you can select an acquirer from the dropdown list.

The ACQUIRER field is mandatory for the Klarna and AfterPay payment methods. For all other payment methods this field is optional.

The acquirer for the Klarna payment method is 'Klarna'.
The acquirer for the AfterPay payment method is 'AfterPay B.V.'.

For more information, see 'Klarna and AfterPay'.


 NOTE

There are two system payment methods: 'On account' and 'Zero'. These payment methods are not shown in Sana Admin and it is not possible to edit them.

The 'On account' payment method can be used by B2B customers and sales agents, if this option is enabled in Sana Admin for B2B customers: Setup > Ordering & checkout > Ordering > Online order payments.

The 'Zero' payment method is used automatically when the total cost of an order is equal to 0.

There is also the Internal (on account) payment provider that is not configurable in Sana Admin, but it can be enabled/disabled. Unlike the system on account payment method, you can create and configure payment methods with the assigned 'Internal (on account)' payment provider. The payment method of the 'Internal (on account)' payment provider is shown in the webstore and can be selected by a customer.


Translate payment method name

Under the Payment methods tab you can also select any available language in the dropdown and provide the names of the payment methods in the selected language. When you translate the payment method name into any language you can also change the icon of the payment method.

 NOTE

While placing an order in the Sana web store a customer can select delivery method, payment method, add reference number and comment. Once the order is placed all this data is stored in the sales order in the ERP system. For information on where you can find this sales order data in ERP, see: