PayPal Payflow Link
PayPal Payflow Link is available for merchants in the United States and Canada only. Customers are not required to have a personal PayPal account, and enter their credit card information in a form that is hosted by PayPal. The information is never stored on your Adobe Commerce or Magento Open Source server. Payflow Link cannot be used for orders that are created from the Admin.
Credit memos are supported for both online and offline refunds. However, multiple online refunds are not supported.
As of September 14, 2019, European banks might decline payments that do not meet PSD2 requirements. To comply with PSD2, PayPal Payflow Link must be integrated with Cardinal Commerce. To learn more, see 3-D Secure for Payflow.
Requirements
-
PayPal Business Account The PayPal Payflow Pro gateway links the merchant account at PayPal with the merchant website, acting as both a gateway and a merchant account.
-
If you manage multiple Commerce websites, you must have a separate PayPal merchant account for each website.
Customer workflow
- Customer goes to the checkout - During checkout, the customer chooses to pay with PayPal Payflow link and enters the credit card information. The customer is not required to have a personal PayPal account.
- Customer chooses Pay Now - The customer taps the Pay Now button to submit the order.
- Customer enters credit card information - The customer enters the credit card information on a form that is hosted by PayPal. If the customer clicks the Cancel Payment link, the customer returns to the Payment Information stage of checkout and the order status changes to Canceled.
- Customer submits the order - The credit card information is submitted directly to PayPal and is not retained anywhere on the Commerce site.
Order workflow
-
PayPal receives request - PayPal receives the request from the customer to Pay Now.
-
PayPal verifies the payment information - PayPal verifies the credit card information, and assigns the appropriate status:
- Payment Verified: If verified, the Pending Payment status is initially assigned to the order until the transaction is settled.
- Processing - The transaction was successful.
- Pending Payment - The system did not receive a response from PayPal.
- Canceled - The transaction was not successful for some reason.
- Suspected Fraud - The transaction did not pass some of the PayPal fraud filters. The system receives the response from PayPal that the transaction is under review by Fraud Service.
- Cancel Payment: If the customer clicks the Cancel Payment link, the customer returns to the Payment Information stage of checkout and the order status changes to Canceled.
-
Customer is redirected to confirmation page - If the transaction is completed successfully, the customer is redirected to the order confirmation page in your store. If the transaction fails on any reason, an error message appears on the checkout page and the customer is directed to repeat the checkout process. These situations are managed by PayPal.
-
Merchant fulfills order - The merchant invoices and ships the order as usual.
Configure your PayPal account
-
Log in to your PayPal business account.
-
Configure the Hosted Checkout Pages using PayPal Manager with the following settings:
-
Under Security Options, complete the following settings:
AVS:
No
CSC:
No
Enable Secure Token:
Yes
-
Choose Customize, and then choose Layout C.
Layout C shows only credit and debit card fields, and can either be framed on your site or used as a stand-alone popup. The size is fixed at 490 x 565 pixels, with extra space for error messages. On some systems, this setting corrects an issue with transparent redirect.
-
-
When the configuration settings are complete, click Save and Publish.
-
Set up an extra user (recommended by PayPal):
-
In the second row of the main menu, click Manage Users.
-
To add another user to the account, click Add User.
-
Complete the required fields in the following sections of the Add User form:
- Admin Confirmation
- User Information
- User Login Information
- Assign Privilege to User
-
Click Update.
-
Set up PayPal Payflow Link
Step 1: Begin the configuration
This setup method assumes you have an existing PayPal account.
-
On the Admin sidebar, go to Stores > Settings > Configuration.
-
In the left panel, expand Sales and choose Payment Methods.
-
If your Commerce installation has multiple websites, stores, or views, set Store View to the store view where you want to apply this configuration.
-
In the Merchant Location section, select the Merchant Country where your business is located.
This setting determines the selection of PayPal Solutions that appear in the configuration.
{width="600" modal="regular"}
-
Expand PayPal Payment Gateways (if needed) and click Configure for Payflow Link.
{width="600" modal="regular"}
Step 2: Complete the required PayPal settings
{width="600" modal="regular"}
-
(Optional) Enter the Email Associated with your PayPal Merchant Account.
note important IMPORTANT Email addresses are case-sensitive. To receive payment, the email address must match the email address specified in your PayPal merchant account. -
Enter one of the following credentials that you use to log in to your PayPal merchant account:
- Partner - Your PayPal Partner ID.
- User - The ID of another user who is set up on your PayPal account.
- Vendor - Your PayPal user login name.
-
Enter the Password that is associated with your PayPal account.
-
To run test transactions, set Test Mode to
Yes
.When testing the configuration in a sandbox, use only credit card numbers that are recommended by PayPal. When you are ready to go to production, return to the configuration and set Test Mode to
No
. -
If your system uses a proxy server to establish the connection to the PayPal system, set Test Mode to
Yes
and do the following:-
Enter the IP address of the Proxy Host.
-
Enter the port number of the Proxy Port.
A proxy is used when the server firewall prevents direct access to the PayPal server. In such a case, a third-party server is used to relay traffic.
-
-
Set Enable Payflow Link to
Yes
. -
If you want to enable PayPal Express Checkout options for customers, set Enable Express Checkout to
Yes
. -
If you want to offer PayPal Credit to your customers, set Enable PayPal Credit to
Yes
.
Step 3: Set up Advertise PayPal Credit / Advertise PayPal PayLater (optional)
Starting with the 2.4.3 release, PayPal PayLater is supported in deployments that include PayPal. This feature allows shoppers to pay for an order in bi-weekly installments instead of paying the full amount at time of purchase. The PayPal Credit experience is deprecated.
Set Enable PayPal PayLater Experience to one of the following:
Yes
- To set up Advertise PayPal PayLaterNo
- To set up Advertise PayPal Credit
Advertise PayPal Credit
-
Expand the Advertise PayPal Credit section.
{width="600" modal="regular"}
-
To get your account information, click Get Publisher ID from PayPal and follow the instructions.
-
Enter your Publisher ID.
-
Expand the Home Page section.
{width="600" modal="regular"}
-
To place a banner on the page, set Display to
Yes
. -
Set Position to one of the following:
Header (center)
Sidebar (right)
-
Set Size to one of the following:
190 x 100
234 x 60
300 x 50
468 x 60
728 x 90
800 x 66
-
Expand the remaining sections and repeat the previous steps for home page configuration:
- Catalog Category Page
- Catalog Product Page
- Checkout Cart Page
Advertise PayPal PayLater
-
Expand the Advertise PayPal PayLater section.
-
Set Enable PayPal PayLater to
Yes
. -
Expand the Home Page section.
{width="600" modal="regular"}
-
To place a banner on the page, set Display to
Yes
. -
Set Position to one of the following:
Header (center)
Sidebar
-
Set Style Layout to one of the following:
Text
Flex
-
For Style Layout Text only, set Logo Type to one of the following:
Primary
Alternative
Inline
None
-
For Style Layout Text only, set Logo Position to one of the following:
Left
Right
Top
-
For Style Layout Text only, set Text Color to one of the following:
Black
White
Monochrome
Grayscale
-
For Style Layout Text only, set Text Size to one of the following:
10px
11px
12px
13px
14px
15px
16px
-
For Style Layout Flex only, set Ratio to one of the following:
1x1
1x4
8x1
20x1
-
For Style Layout Flex only, set Color to one of the following:
Blue
Black
White
White No Border
Gray
Monochrome
Grayscale
-
Expand the remaining sections and repeat the previous steps:
- Catalog Product Page
- Checkout Cart Page
- Checkout Payment Step
- Catalog Category Page
Step 4: Complete the basic settings
-
Expand the Basic Settings - PayPal Payflow Link section.
{width="600" modal="regular"}
-
For Title, enter a title that identifies PayPal Payflow Link during checkout.
It is recommended that you use the title Debit or Credit Card.
-
If you offer multiple payment methods, enter a number for Sort Order to determine the sequence in which Payflow Link appears when listed with the other payment methods.
This number is relative to the other payment methods. (
0
= first,1
= second,2
= third, and so on.) -
Set Payment Action to one of the following:
Authorization
- Approves the purchase and puts a hold on the funds. The amount is not withdrawn until it is captured by the merchant.Sale
- The amount of the purchase is authorized and immediately withdrawn from the customer’s account.
Step 5: Complete the advanced settings
-
Expand the Advanced Settings section.
{width="600" modal="regular"}
-
Set Payment Applicable From to one of the following:
All Allowed Countries
- Customers from all countries specified in your store configuration can use this payment method.Specific Countries
- After choosing this option, the Payment from Specific Countries list appears. Hold down the Ctrl key and select each country in the list where customers can make purchases from your store.
-
To write communications with the payment system into the log file, set Debug Mode to
Yes
.note note NOTE In accordance with PCI Data Security Standards, credit card information is not recorded in the log file. -
To enable host authenticity verification, set Enable SSL Verification to
Yes
. -
If you want the customer to be able to correct their entry of the three-digit CVV security code from the back of a credit card, set CVV Entry is Editable to
Yes
. -
To require customers to enter a CVV code, set Require CVV Entry to
Yes
. -
To send a confirmation of the payment to the customer, set Send Email Confirmation to
Yes
. -
To determine the method that is used to exchange information with the PayPal server during a transaction, set the URL method for Cancel URL and Return URL to one of the following:
GET
- Retrieves information that is the result of a process (default method).POST
- Provides a block of data, such as data entered into a form, to a data handling process.
The Cancel URL and Return URL refer to the page where the customer returns after completing or canceling the payment part of the checkout process on the PayPal server
-
Complete the following sections, as needed for your store:
Settlement Report Settings
-
Expand the Settlement Report Settings section.
{width="600" modal="regular"}
-
For SFTP Credentials, do the following:
-
If you have signed up for the PayPal Secure FTP Server, enter the following SFTP login credentials:
- Login
- Password
-
To run test reports before going live with Express Checkout on your site, set Sandbox Mode to
Yes
. -
Enter the Custom Endpoint Hostname or IP Address.
By default, the value is
reports.paypal.com
. -
Enter the Custom Path where reports are saved.
By default, the value is
/ppreports/outgoing
.
-
-
To generate reports according to a schedule, complete the Scheduled Fetching settings:
-
Set Enable Automatic Fetching to
Yes
. -
Set Schedule to one of the following:
Daily
Every 3 Days
Every 7 Days
Every 10 Days
Every 14 Days
Every 30 Days
Every 40 Days
PayPal retains each report for 45 days.
-
Set Time of Day to the hour, minute, and second when you want the reports to be generated.
-
Frontend Experience Settings
Use the Frontend Experience Settings to choose which PayPal logos appear on your site, and to customize the appearance of your PayPal merchant pages.
-
Expand the Frontend Experience Settings section.
{width="600" modal="regular"}
-
Select the PayPal Product Logo that you want to appear in the PayPal block in your store.
The PayPal logos are available in four styles and two sizes:
No Logo
We Prefer PayPal (150 x 60 or 150 x 40)
Now Accepting PayPal (150 x 60 or 150 x 40)
Payments by PayPal (150 x 60 or 150 x 40)
Shop Now Using PayPal (150 x 60 or 150 x 40)
-
To customize the appearance of your PayPal merchant pages:
-
Enter the name of the Page Style that you want to apply to your PayPal merchant pages:
paypal
- Uses the PayPal page style.primary
- Uses the page style that you identified as the primary style in your account profile.your_custom_value
- Uses a custom payment page style, which is specified in your account profile.
-
For Header Image URL, enter the URL of the image that you want to appear in the upper-left corner of the payment page. The maximum file size is 750 pixels wide by 90 pixels high.
note note NOTE PayPal recommends that the image resides on a secure (https) server. Otherwise, a browser may warn that the page contains both secure and nonsecure items. -
To set the color for your pages, enter the six-character hexadecimal code, without the
#
symbol, for each of the following:- Header Background Color - Background color for the checkout page header.
- Header Border Color - Color for two-pixel border around the header.
- Page Background Color - Background color for the checkout page and around the header and payment form.
-
Step 6: Complete the basic settings for PayPal Express Checkout
-
Expand the Basic Settings - PayPal Express Checkout section.
{width="600" modal="regular"}
-
For Title, enter a title that identifies this payment method during checkout.
Setting the title to PayPal for each store view is recommended.
-
If you offer multiple payment methods, enter a number for Sort Order to determine the sequence in which PayPal Express Checkout appears when listed with the other payment methods.
This number is relative to the other payment methods. (
0
= first,1
= second,2
= third, and so on.) -
Set Payment Action to one of the following:
Authorization
- Approves the purchase and puts a hold on the funds. The amount is not withdrawn until it is captured by the merchant.Sale
- The amount of the purchase is authorized and immediately withdrawn from the customer’s account.
-
To display the Check out with PayPal button on the product page, set Display on Product Details Page to
Yes
.
Step 7: Complete the advanced settings for PayPal Express Checkout
-
Expand the Advanced Settings section.
{width="600" modal="regular"}
-
Set Display on Shopping Cart to
Yes
. -
Set Payment Applicable From to one of the following:
All Allowed Countries
- Customers from all countries specified in your store configuration can use this payment method.Specific Countries
- After choosing this option, the Payment from Specific Countries list appears. To select multiple countries, hold down the Ctrl key (PC) or the Command key (Mac) and click each item.
-
To write communications with the payment system into the log file, set Debug Mode to
Yes
.note note NOTE In accordance with PCI Data Security Standards, credit card information is not recorded in the log file. -
To enable host authenticity verification, set Enable SSL Verification to
Yes
. -
To display a full summary of the customer order by line item from the PayPal site, set Transfer Cart Line Items to
Yes
. -
To allow the customer to complete the transaction from the PayPal site without returning to your store for Order Review, set Skip Order Review Step to
Yes
. -
When complete, click Save Config.