Payment Gateway Configuration
If a new PayPal PayFlow Pro Payment Gateway account needs to be purchased and configured, the following account manager can be contacted:
Jared Pass
Manager
Inbound Merchant Solutions
Business Support: 888.215.5506
Integration: 855.684.1965 9-6 CST (M-F)
Setting Up PayFlow Pro
Credentials
Credentials to enter into the system are the same ones that must be entered into manager.paypal.com
It is
 |
Partner: Payment Gateway Partner Merchant Login: Payment Gateway Username and Payment Gateway Merchant User (optional): Typically a separate user account is set up specifically for A2Z Password: Payment Gateway Password |
The information is entered into Event Configuration (Events > Settings > Event Configuration).
In Event Configurations, complete the following fields:
- Payment Gateway User Name - if you are using a separate user for the gateway, enter the username. Otherwise enter Merchant Name again.
- Payment Gateway Password -the password that matches the UserName or Merchant account. Password will be encrypted once it's saved.
- Payment Gateway Merchant - your main account name
- Payment Gateway Partner the vendor through whom PayPal was purchased.
- Payment Gateway HostAddress payflowpro.paypal.com for live mode or pilot-payflowpro.paypal.com for test mode
- Payment Gateway Comment1 prefix in Comment 1 which will appear along with the company identification.
- Payment Gateway Comment2 an additional comment field if desired.
- Payment Gateway Currency Code - USD for US dollars. Additional currency codes can be found on PayPal's developer site.
Testing
It is recommended that a live transaction is added with a real credit card to ascertain both that the portal was configured correctly and that the funds deposit as expected. Once the payment has cleared it is possible to refund oneself the transaction.
As a preliminary step, if only needing to ensure that the connection works, it is not necessary to pay with a live card. If a test payment is done with a valid card number even if it's not a real card it will decline (rather than show a bad credentials message). You can submit a test payment with test credit card information to ensure a Decline/appropriate response from the Payment Gateway
Test Mode
To place the system in Test Mode change the URL field to: pilot-payflowpro.paypal.com
When you are in Test Mode a message is displayed at the top of the Financial dashboard:
Valid test card numbers can be found at this PayPal resource. Use any name and any future date for expiration date.
For PayPal the payment limit on a test mode transaction is under $1000.
Live Mode
In Live Mode the URL is payflowpro.paypal.com
Use a valid credit card.
Adding a Test Transaction
-
- Go to a Test Company in A2Z > on the Payments page, submit a $1.00 Online Credit Card Payment
- If you get a GREEN successful message in on the Payment screen, confirm that it went through to Paypal by checking your PayPal account.
- If you get a RED error message on the Payment screen, you can look up the specific error message from PayPal under Reports > Custom Reports > Custom Reports . The report may be named Verisign or Payment or PayPal or Credit Card Log > click the 'View' icon next to the report. (If no report of any of these names is found, work with your deployment or support team.)
- Use Online Credit Card Refund Payment Mode on the Company Payments tab to refund the card.
- Go to a Test Company in A2Z > on the Payments page, submit a $1.00 Online Credit Card Payment
Suggested Payment Configurations within PayPal
PayPal Support (How to obtain the Account and Credentials) : Click Here
- User Predefined Role = FULL_API_ACCESS (API_FULL_TRANSACTIONS)
-
Block Accidental Payments = No, allow multiple payments per invoice IDA2Z only stores one Invoice ID per company/per event, and if an exhibitor wants to make more than one payment against the Invoice ID, this setting will allow them to do so.
To update the block accidental payments setting, follow these instructions below:
- Log in to your PayPal account
- Hover over your Name on the top right
- Click on Account Settings
- Click on Payment preferences then update next to Block payments
There will be the setting "Block accidental payments" as the second setting.
-
Allow Reference Transactions = Yes
When you perform a transaction, you generate a Transaction ID. You can use this ID, or token, to initiate subsequent transactions, even when you're not storing the credit card information in your local database. This can save you from
Having to ask the buyer for their credit card ID again.
The burden of complying with PCI requirements for storing credit card information.For Reference Transactions only PayPal's customer service team has access to the tool to request reference transactions. It requires a back end team to review your account, and they will perform a credit check. If your account qualifies for reference transactions after being reviewed by a back end team, then it will be enabled on your account.
To enable reference transactions on your account, please work with the customer support team.
- Log in to your account at www.paypal.com.
- Click Help at the top of the page.
- Click Help Center at the bottom of the page.
- Scroll to the bottom and click "Contact Us"
-
Choose "Message Us" at the bottom.
Troubleshooting
Error Codes
- 15005: Processor Decline - This transaction cannot be processed.
- 15006: Processor Decline - This transaction cannot be processed. Please enter a valid credit card number and type.
- 15007: Processor Decline - This transaction cannot be processed. Please use a valid credit card.
Cause
Error codes 15005, 15006 and 15007 all indicate a processor decline. Processor declines result directly from the financial information entered and aren't under PayPal's control.
Solution
The merchant must request that the buyer either use a different funding source for the payment, or contact their issuing bank (call the customer service number on the back of the credit card being declined).
Note: PayPal doesn't give merchants specific reasons for payment declines. If more information is required, have the buyer contact PayPal Business Support.
In general:
- 15005 errors result from an AVS decline, usually caused by the billing address not matching the card issuer's information on file. The card-issuing bank may also have declined the transaction due to lack of funds.
- 15006 errors occur when a hold exists on the card or the card-issuing bank's system has flagged it.
Field format error: 91537-Purchase order number is too long.Purchase order number must be 17 characters or shorter and can only contain printable ASCII characters.
- a2z Event Name is passed to Purchase Order Number in Paypal. This field is only 17 characters long on PayPal side, and if the event name is longer than that, they send a code that refuses the transaction. Please shorten the name of the event to be 17 characters or fewer.
Generic processor error: 10001-Internal Error
- This is an internal error on PayPal side and must be diagnosed by them. No further information is available to us.
User Authentication Failed
See full support article here: https://www.paypal.com/us/smarthelp/article/why-did-i-get-the-error-user-authentication-failed-or-merchant-identification-error-ts1223
The most common issues are:
- The account credentials are incorrect
- In some instances, special characters in the Password field can cause issues
- The client has restricted PayFlow Pro to specific IP addresses:
A2Z PayPal IP
3.215.93.31 (as of 12/6/2019)