PayPal Payments Pro brings you all the benefits of a merchant account and payment gateway in one, plus the ability to create your own, fully customized checkout experience. PayPal Express Checkout is automatically enabled with PayPal Payments Pro, so you can tap into more than 110 million active PayPal users.
PSD2 Requirements:
As of September 14, 2019, European banks might decline payments that do not meet PSD2 requirements. To comply with PSD2, PayPal Payments Pro must be integrated with a third-party plugin.
Currently, PayPal Payments Pro is available in the US, UK, and Canada.
At the customer’s request, the store administrator can also create an order from the Admin and process the transaction with PayPal Payments Pro.
Order placed - The order can be processed either the Admin of your store, or from your PayPal merchant account.
Payment Action - The payment action specified in the configuration is applied to the order. Options include:
Invoicing - An invoice is created in Commerce after PayPal sends an instant payment notification message to Commerce.
Make sure that instant payment notifications are enabled in your PayPal merchant account.
If necessary, an order can be partially invoiced for a specified quantity of products. For each partial invoice submitted, a separate Capture transaction with a unique ID becomes available, and a separate invoice is generated.
Authorization-only payment transactions are closed only after the full order amount is captured.
An order can be voided online at any time until the order amount is fully invoiced.
Returns - If the customer returns the purchased products and claims a refund, as with order amount capturing and invoice creation, you can create an online refund either from the Admin or from your PayPal merchant account.
Before you set up PayPal Payments Pro in Commerce, you must configure your merchant account on the PayPal website.
Log in to your PayPal business account.
In the PayPal Manager menu, choose Service Settings.
Under Hosted Checkout Pages, click Set Up.
Under Choose your settings, set Transaction Process Mode to Live
.
Under Display options on payment page, set Cancel URL Method to POST
.
Under Billing Information, select the card security code CSC checkboxes for both required and editable fields.
Under Payment Confirmation, set Return URL Method to POST
.
Under Security Options, configure the following:
No
No
Yes
Click Save Changes.
In the PayPal Manager menu, choose Service Settings and under Hosted Checkout Pages, choose Customize.
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.
Click Save and Publish.
In the PayPal Manager menu, choose Account Administration. Under Manage Security, click Transaction Settings.
Set Allow reference transactions to Yes
.
Click Confirm.
If you have multiple Commerce websites, you must create a separate PayPal Payments Pro account for each.
Set up another 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. The link is located just above the Manage Users title.
Complete the required fields in the following sections of the Add User form:
Click Update.
Make sure to log out of your PayPal account.
You can have two PayPal solutions active at the same time: PayPal Express Checkout, plus any one of the all-in-one solutions. If you change payment solutions, the one used previously is automatically disabled.
Click Save Config at any time to save your progress.
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.
Expand PayPal All-in-One Payment Solution and click Configure for Payments Pro.
Expand the Payments Pro and Express Checkout section.
(Optional) Enter the Email Associated with your PayPal Merchant Account.
Email addresses are case-sensitive. To receive payment, the email address must match the email address specified in your PayPal merchant account.
If you do not have a PayPal account, click Start accepting payments via PayPal.
Enter one of the following credentials that you use to log in to your PayPal merchant account:
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 Use Proxy 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 this Solution to Yes
.
If you want to offer PayPal Credit to your customers, set Enable PayPal Credit to Yes
.
If you want to securely store customer payment/credit card details, so customers do not have to reenter payment information each time, set Vault Enabled to Yes
.
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 CreditExpand the Advertise PayPal Credit section.
To get your account information, click Get Publisher ID from PayPal and follow the instructions.
Enter your Publisher ID.
Expand the Home Page section.
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:
Expand the Advertise PayPal PayLater section.
Set Enable PayPal PayLater to Yes
.
Expand the Home Page section.
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:
Expand the Basic Settings - PayPal Payments Pro section.
For Title, enter a title that identifies PayPal Payments Pro 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 PayPal Payments Pro appears when listed with other payment methods during checkout.
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, but 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 account.For Credit Card Settings, select the credit cards that you accept for payment in your store.
To select multiple cards, hold down the Ctrl key (PC) or the Command key (Mac) and click each one.
American Express requires an extra agreement.
Expand the Advanced Settings section.
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 (PC) or the Command key (Mac) 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
.
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 require customers to enter a CVV code, set Require CVV Entry to Yes
.
Expand the CVV and AVS Settings section.
To determine when a transaction should be rejected when the Address Verification System identifies a mismatch, specify how to handle each of the following scenarios:
To reject a transaction based on a mismatched street mismatch, set AVS Street Does Not Match to Yes
.
To reject a transaction based on a mismatched ZIP code, set AVS Zip Does Not Match to Yes
.
To reject a transaction based on a mismatched country identifier, set International AVS Indicator Does Not Match to Yes
.
To reject a transaction based on a mismatched CVV code, set International Card Security Code Does Not Match to Yes
.
Complete the following sections, as needed for your store:
Expand the Settlement Report Settings section.
For SFTP Credentials, do the following:
If you have signed up for PayPal’s Secure FTP Server, enter the following SFTP login credentials:
To run test reports before going live with Payments Pro 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.
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.
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, do the following:
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.
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:
Expand the Basic Settings - PayPal Express Checkout section.
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
.
Expand the Advanced Settings section.
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
.
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.