User GuideSetup

Payment Methods

Sana Commerce 9.0
Your connector

PayPal Payflow Link

PayPal Payflow Link payment provider enables your customers to use credit cards for payments. The credit card transactions are processed by PayPal Payflow payment gateway.

Although Payflow is provided by PayPal, it does not enable your customers to pay via their PayPal account. If you want your customers to be able to pay via their PayPal account, you need to use the PayPal Express Checkout payment provider.

It is possible to enable both payment providers side by side.

To configure the PayPal Payflow Link payment provider and payment methods you should have the PayPal Payflow Link test/live account with all the necessary data.

The table below provides the description of the PayPal Payflow Link payment provider fields:

Field Description
LOGIN This is the name of the Payflow Link account used by PayPal. This information will be provided by PayPal when creating an account.
Default value: depends on the account (test/ live)
PARTNER This is the partner of the Payflow Link account. The partner for the accounts directly acquired from PayPal is 'PayPal'. For the accounts acquired from the PayPal resellers, the partner will be different.
Default value: PayPal
SHOWCONFIRM Indicates whether an additional confirmation page is shown during the payments via PayPal. Allowed values are 'true' and 'false'.
Default value: true
IpRange It is used as a security measure to prevent fraud. Some payment providers pass the payment status of an order by calling the confirm page. In this case it is possible for a malicious user to simulate this call and change the status of the order. To prevent this, a check on the IP of the call can be made by specifying the allowed IP (ranges) in this field.
Multiple values can be separated by the '|' character.

More detailed information about the PayPal parameters can be found on the official PayPal web site.

Configure Payflow Link in the PayPal Manager backoffice under: Service Settings > Configuration:

Name Value
Return URL Method Post
Return URL http://<domain>/checkout/ordersubmit
Silent POST URL (checkbox) Checked
Silent POST URL http://<domain>/confirm/payment
Force Silent Post Confirmation Checked
Failed Silent Post Return URL http://<domain>/checkout/orderfailed
Transaction Process Mode Test

Uncheck all the check boxes for Required Fields and Editable Fields under Billing Information and Shipping Information. This information will be provided by the Sana Commerce webstore.

Customize the look and feel of the Payflow Link pages in the PayPal Manager backoffice.

  When you upgrade the Payflow Link test account to live you should set the Transaction Process Mode to Live in the PayPal Manager backoffice.

Make sure that your firewall does not restrict outbound access to the PayPal IP addresses. Thus, you should add PayPal IP addresses to the list of trusted IP addresses to permit traffic to and from PayPal and prevent problems with processing transactions. PayPal recommends using the DNS hostname to determine the IP addresses of their servers. For more information see 'IP Address for PayPal servers' on PayPal Merchant Technical Support.

When PayPal Express Checkout is configured you can set up the necessary payment methods in Sana Admin that are supported by PayPal Express Checkout.

For information about how to create and configure payment methods in Sana Admin, see 'Payment methods'.

Test the payment/checkout flow to see if everything works fine using the created payment methods and the correct payment statuses.

When everything is done and tested, keep an eye on the payment log in the following days to be sure that everything is configured correctly.

Configuring PayPal Payflow Link for Multiple Webstores

The values of the 'Return URL', 'Silent POST URL' and 'Failed Silent Post Return URL' PayPal Payflow Link configuration settings only allowed on an account level. These configuration settings cannot be configured on a transaction level. You cannot use the same PayPal account for multiple webstores, because these configuration settings contain the domain of the webstore.

In order to use PayPal Payflow Link on multiple webstores, you will have to configure different PayPal accounts per webstore; one for each webstore you are using. The 'Return URL', 'Silent POST URL' and 'Failed Silent Post Return URL' configuration settings of these accounts should point to a different webstore domain per account.

User GuideSetup