...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Table of Contents | ||
---|---|---|
|
Overview
PayPal is an industry leader in payment processing services. PayPal can be implemented as a supplemental payment processing service as well as an all-in-one payment processing service that combines the PayPal-to-PayPal payment processing along with direct credit card processing (where the customer in the UltraCart checkout without any redirect to the PayPal website for login.
Business PayPal Account
...
Important PayPal API Update Available - June 2023
Info | ||
---|---|---|
| ||
Attention Merchants, UltraCart has a new API integration with PayPal, please upgrade to the new API in order to take advantage of the new functionality and better user experience that the new API provides: Upgrading to PayPal Order API (2023) Benefits
|
Table of Contents | ||
---|---|---|
|
Overview
PayPal is an industry leader in payment processing services. PayPal can be implemented as a supplemental payment processing service as well as an all-in-one payment processing service that combines the PayPal-to-PayPal payment processing along with direct credit card processing (where the customer in the UltraCart checkout without any redirect to the PayPal website for login.
Business PayPal Account
You'll need a business paypal account. To upgrade your current PayPal Personal Account to a Business or PremierAccount: Go to https://www.paypal.com/UPGRADE and log in to your PayPalaccount. Click the Upgrade Now button at the bottom of the page. The next page will allow you to choose a personal Premier Account or a Business Account.
Integration Options
There are two integration options to choose from: Express Checkout & Website "Payment Pro".
...
- Enter your business email address associated with your PayPal business account (if you have a personal PayPal account, you'll need to upgrade it to a business account.)
- Choose "Express Checkout" from the "Integration Method" drop-down menu
- Configure your "Instant Payment Notification (IPN) to the following URL: https://secure.ultracart.com/cgi-bin/UCPayPalNotify
- Set Third-Party API permissions to: paypal_api1.ultracart.com
- From the "Advanced Options" section choose "Live" from the drop-down menu.
...
- Enter your business email address associated with your PayPal business account (if you have a personal PayPal account, you'll need to upgrade it to the business account.)
- Choose "PayPal Website Payments Pro (Express Checkout and Direct Payments)" from the "Integration Method" drop-down menu
- Configure your "Instant Payment Notification (IPN) to the following URL: https://secure.ultracart.com/cgi-bin/UCPayPalNotify
- Set Third-Party API permissions to: paypal_api1.ultracart.com
- From the "Advanced Options" section choose "Live" from the drop-down menu.
- Click the save button
...
Info | ||
---|---|---|
| ||
These limitations are caused by PayPal's inability to handle the same level of customization that UltraCart's recurring orders possess.
There are two possible actions in regard to an active auto order:
|
UltraCart Account Settings for Subscriptions
Navigate to Configuration → Back-Office → Auto Order Processing → Payment Settings → Paypal (Section) Advanced Settings (button) → "Send Recurring Flag" Select Yes, then save the changes.
Follow the instructions there.
...
When viewing the auto order record of a recurring payment in UltraCart, you'll see the following message regarding the management of the subscription:
Active
...
Info |
---|
The email notification will be sent out to all users on the account that have the "edit settings" permission configured. |
Allow UltraCart To Call The [chargeCreditCard] API
If you do not have the chargeCreditCard API permission turned on, you receive a message like this (body text below):
Subject: UltraCart [UC MerchantID] - PayPal permissions incorrect.
Hi <name of merchant as listed on the user login>,
This automated email is to inform you that your PayPal integration has not been configured properly to allow UltraCart to call the [chargeCreditCard] API. Please contact support for assistance in adjusting your configuration.
-UltraCart
The solution
To fix this issue, login to your PayPal account and:
1) Under the My Account menu click on the Profile option.
2) On the left side of the page under My Profile click on My Selling Tools.
3) Click the Update link to the right of API Access.
4) Edit the API access and grant permission for UltraCart to call [chargeCreditCard]
Until you grant permission for UltraCart to call chargeCreditCard, your customers can not use direct credit cards during the checkout. This is limiting your sales to PayPal only.
Info | ||
---|---|---|
| ||
This message gets triggered whenever PayPal returns error code 10002 for a transaction. So, you may receive this notification multiple times. |
UltraCart has received ERROR: 10501
Hi <name>,
UltraCart has received ERROR: 10501 Invalid Configuration This transaction cannot be processed due to an invalid merchant configuration from PayPal.
Make sure that you have accepted the "PayPal Payments Pro" agreement in your PayPal account after you have been approved by PayPal for PayPal Payments Pro. If you have accepted their agreement but are still getting this error, PayPal also occasionally acknowledges the agreement and activates Virtual Terminal but somehow misses activating PayPal Payments Pro itself; if your PayPal "Get Started" summary screen only shows Virtual Terminal and nothing about PayPal Payments Pro, please contact PayPal support to get your PayPal Payments Pro service activated.
If you are only using PayPal Payments Standard with a regular PayPal personal, Business or Premier account (i.e., if you have not upgraded to PayPal Payments Pro), please go to Seller Admin > Payment Preferences and make sure you have PayPal Payments Standard checked (rather than PayPal Payments Pro) and click Submit to save any changes you make.
-UltraCart
The solution
To fix this issue, login to your PayPal account and:
1) Under the My Account menu click on the Profile option.
2) On the left side of the page under My Profile click on My Selling Tools.
3) Click the Update link to the right of API Access.
4) Edit the API access and grant permission for UltraCart to call [doCapture]
Until you grant permission for UltraCart to call doCapture, the orders will be stuck in "Payment Status = pending".
About Authorization Model
...
Here are some of the common errors that we see in UC Accounts:
...
Duplicate transaction attempt.
Affiliate Management MassPay API Errors
...
While attempting to process payments for affiliates, an error appears on the page that says "PayPal MassPay API failed. You do not have permissions to make this API Call". This error means that you need to grant access to that particular API call within your PayPal account so that UltraCart can call it. Log into your PayPal account, then navigate:
Panel | ||
---|---|---|
| ||
My Account → Profile → My Settings → My Selling Tools → API Access [update]. |
...
PayPal AMEX Support
PayPal now requires all merchants that would like to use AMEX in their PayPal account to sign an agreement directly with American Express.
Error Message
If you are getting the following error:
...
L_ERRORCODE1
...
10566
...
L_LONGMESSAGE1
...
The credit card type is not supported
...
L_SEVERITYCODE1
...
Error
...
L_SHORTMESSAGE1
...
Credit card type unsupported
this means that you have not accepted the PayPal AMEX agreement. Until you do this on your PayPal account it will not support American Express. You can read more about this at PayPal's AMEX Update.
...
:
error code | error meaning |
---|---|
0005 | The transaction was declined without explanation by the card issuer |
0013 | The transaction amount is greater than the maximum the issuer allows. |
0014 | The issuer indicates that this card is not valid. |
0043 | The card has been reported stolen |
0051 | The credit limit for this account has been exceeded. |
0054 | The card is expired. |
1015 | The credit card number was invalid |
1511 | Duplicate transaction attempt. |
Affiliate Management MassPay API Errors
PayPal MassPay Errors related to processing affiliate commissions via PayPal MassPay
While attempting to process payments for affiliates, an error appears on the page that says "PayPal MassPay API failed. You do not have permissions to make this API Call". This error means that you need to grant access to that particular API call within your PayPal account so that UltraCart can call it. Log into your PayPal account, then navigate:
Panel | ||
---|---|---|
| ||
My Account → Profile → My Settings → My Selling Tools → API Access [update]. |
Under that section within PayPal.com, you'll need to give the UltraCart API login the additional permission to do MassPay, then save the changes.
PayPal AMEX Support
PayPal now requires all merchants that would like to use AMEX in their PayPal account to sign an agreement directly with American Express.
Error Message
If you are getting the following error:
L_ERRORCODE1 | 10566 |
L_LONGMESSAGE1 | The credit card type is not supported |
L_SEVERITYCODE1 | Error |
L_SHORTMESSAGE1 | Credit card type unsupported |
this means that you have not accepted the PayPal AMEX agreement. Until you do this on your PayPal account it will not support American Express. You can read more about this at PayPal's AMEX Update.
Frequently asked Questions
Question: We upgraded from the legacy API to the new PayPal API and are now seeing that our paypal orders are showing the following message n the status section of the auto order editor: 'PayPal details lack status.' Is the auto order now broken?
Answer: While PayPal is not longer reporting a status for the auto order, Ultracart will capture any payments send back via the Instant Payment Notification, and will process the order accordingly. You will, however, need to log into PayPal to cancel or modify the existing auto order.
Question: I have an item configured with $0.00 item cost and a flat shipping cost. When I test a checkout with this item, I'm getting an error message that Paypal cannot process a free offer. Why?
...