PayPal Payflow Pro

Setting Up PayPal

Commercio is currently integrated with payment gateway PayPal Payflow Pro, and in order to publish stores that accept payment, your organization needs an account. After your account is established, you will create an API user and add your Payflow credentials to your Account Settings. If you have created an API User for use with PopUpShops, you can skip to How to Update CompanyStore with Payflow API User Credentials.

How to Sign-Up for a PayPal Payflow Pro Account

1. Go to https://www.paypal.com/us/webapps/mpp/payflow-payment-gateway
2. Select Get Started Today
3. Select Payflow Pro in the Choose your gateway pop-up window.
4. To proceed, gather the following:
   • General account information
   • Merchant bank and processor information
   • Credit card and billing information
5. Select Continue
6. After creating your account, confirm that you can login to PayPal Manager at manager.paypal.com to configure and manage your Payflow Pro account.

How to Create an API User

1. Login to your Payflow Pro account by entering your Payflow Manager login credentials (not your PayPal account credentials).
2. Select Account Administration in the top navigation menu.
3. Select Add Users from the Manage Users category.
4. In the User Information section, enter a contact name and email address.
5. In the User Login Information section, enter the user name.
   • We recommend using Commercio because it is easy to use and identify.
6. Enter a new password for the API user that is different than your mechant or admin password.
7. Re-enter the password in the Confirm User Password field.
   • Note: Be sure to record the exact spelling and use of capitalization and characters for both the User Login Name (API User) and the User Password (API User Password) as you will need them later and they must be accurately entered in order for your Commercio Pop Up Shops to be published and accept payments!
8. In the Assign Privilege to User Section, select API_FULL_TRANSACTIONS from the Select Predefined Role drop-down selection.
9. In the User Status drop-down, select Active.
10. Enter the security code as shown or heard in the final field.
11. Select Update.

How to Update Payflow Settings for Compatibility

1. In the top navigation menu, select Service Settings, then select Setup.
2. In the Choose your Settings section, ensure that the transaction Process Mode is set to Live.
3. In the Silent Post for Data Transfer section, select Yes in the Use Silent Post dropdown.
4. In the Security Options section near the bottom of the page, toggle the Enable Secure Token selection to Yes.
5. Select Save Changes.
6. Return to the Account Administration in the top navigation menu.
7. in the Manage Security section, select Transaction Settings.
8. In the Allow Reference Transactions, select the Yes.
9. Select Confirm.

How to Update CompanyStore with Payflow API User Credentials

1. Login to Commercio Company Stores.
2. Click Jump In! next to the store where you will accept credit cards.
3. In the side navigation menu, click Payment Methods and Credit Card.
4. In Basic Settings move slider to Accept.
5. Speak with a local tax professional before making decisions about suppressing taxes.
6. Select the accepted credit cards by checking the box in the top right corner.
   Note that you can also enter an "Alt. Card Code" in this section. This is useful if you have integrations with data management tools like ASI or accounting software like Sage to make passing data between the platforms much cleaner.
7. In the Select an online credit card gateway section, select PayPal PayFlow Pro
8. Enter your PayFlow Pro Vendor ID, Username, and Password.
9. Remember to click Save to apply your selections.

How to Update PopUp Store Payflow API User Credentials

1. Login to PopUp Stores.
2. Click on Account > Settings to open the Edit Account Settings screen.
3. In the Global Account Settings section, click PayFlow.
4. Enter your PayFlow Pro Vendor ID, Username, and Password.
5. Click Save PayFlow Settings to apply your selections.

Each time you publish a new pop up shop for the first time, our system runs a test to confirm that your Payflow account is set up correctly for processing payments. If the preferences on your Payflow account are not set up correctly or if there is an issue with your Payflow Pro Login or API User credentials, you may encounter an error message.

How Do I Update My PayFlow Account Settings?

1. Payflow Pro Account Settings

Before you can accept payments, you need to set up an API User.Login to your Payflow Pro account by entering your Payflow Manager login credentials (not your PayPal account credentials). Click on Account Administration > Manage Users > Add User

Fill out the Add User form as you see below. Under the “Assign privilege to User” section, be sure to select “API_FULL_TRANSACTIONS” for the “Predefined Role”. Visit this page on the PayPal website for more information about this setting. **Note: Be sure to record the exact spelling and use of capitalization and characters for both the User Login Name (API User) and the User Password (API User Password) as you will need them later and they must be accurately entered in order for your Commercio Pop Up Shops to be published and accept payments!

2. Payflow Pro Account Service Settings

Under Service Settings > Set Up and Choose Your Settings, toggle the Transaction Process Mode to “Live”:

Scroll to the bottom of the page and under Security Options, toggle the Enable Security Token to “Yes”. Be sure to Save Changes.

Now, go to: Service Settings > Hosted Checkout Pages > Set up. Find the section called “Silent Post for Data Transfer” and set this to “Yes“:

Under Account Administration > Manage Security > Transaction Settings. Please set “Yes” for “Allow Reference Transaction“.

3. API User Integration

Return back to the Account Settings page on Commercio and enter your PayPal information in the three fields provided.

Once you have completed the above steps and before you launch your first pop up shop, you will want to set up the rest of your General Account Settings.

Each time you publish a new pop up shop for the first time, our system runs a test to confirm that your Payflow account is set up correctly for processing payments. If the preferences on your Payflow account are not set up exactly right or you have made a mistake in entering your user credentials into your Commercio merchant account settings, you may encounter an error message. To find out how to resolve issues, please visit our troubleshooting article in the knowledge base.

PayFlow Troubleshooting

Troubleshooting Payflow Pro Payments Processing

Each time you publish a new campaign for the first time, the Commercio system runs a test to confirm that your Payflow account is set up correctly for processing payments. If the preferences on your Payflow account are not set up exactly right or you have made a mistake in entering your user credentials, you may encounter one of the following error messages:

MESSAGE 1: USER AUTHENTICATION FAILED

What to do: If you receive the message below, it is most likely an error with the API User credentials that you entered on your account settings page. It is not uncommon to accidentally mistype your user name and password so be sure to go back and check that every character, capitalization and spacing is correct. You may need to log in to your Payflow Manager account to reconfirm the login credentials for your API User.

MESSAGE 2: PAYPAL EXPRESS CHECKOUT IS NOT SET UP ON THIS ACCOUNT

What to do: If you receive the above message, log in to your Payflow Manager account and confirm that the Transaction Process Mode is set to “Live”.

MESSAGE 3: SECURE TOKEN IS NOT ENABLED.

What to do: If you receive this message, please review the “Secure Token” settings in your Payflow Manager Account and be sure your “Enable Secure Token” toggle is set to “Yes”.

MESSAGE 4: INVALID MERCHANT INFORMATION

What to do: This message may appear when the first transaction on the first campaign using a new Payflow account is submitted. If you receive this message, it is most likely because you need to verify your PayPal account or make changes to your merchant account configuration through PayPal. To find out how to verify your PayPal account, visit this link. Possible error codes:o 10001 – Account is not verifiedo 10501 – Invalid Merchant Configuration

Updated August 28, 2024 14:02