PayPal API permission errors

API Error Notifications Emails

If UltraCart recognizes PayPal permissions configuration within your PayPal account that is preventing proper processing of payment transactions for your order, you may receive email notifications to that effect.

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.

 

 

 

About repeated notices

This message gets triggered whenever PayPal returns error code 10002 for a transaction. So, you may receive this notification multiple times.

If transactions were previously processing through PayPal okay then suddenly you receive these problem notices, its possible that PayPal is experiencing some sort of temporary processing problem on their end. You should investigate with paypal and make sure that you have the [chargeCreditCard] configured.

*IF you do, then you should contact paypal to inquire about processing issues on their end.

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

 

Authorization Model

The configuration of the "Authorization Model" will affect the point at which the authorized payment is captured:

  • "Auth and Capture" - Capture will occur upon the authorization when the customer is sent over to paypal to make their payment
  • "Auth then Capture" - "doCapture" call will occur when the order is marked as shipped from the shipping department.

Paypal Errors

Here is a link to a spreadsheet of PayPal Virtual Terminal error responses, what they mean, and what you can do about them:

https://www.paypalobjects.com/en_US/vhelp/servicemanagement_help/vterror.htm

Here is a list of Address Verification System Responses:

https://www.paypalobjects.com/en_US/vhelp/servicemanagement_help/avs_response.htm

Here are some of the common errors that we see in UC Accounts:

 

error codeerror meaning
0005The transaction was declined without explanation by the card issuer
0013The transaction amount is greater than the maximum the issuer allows.
0014The issuer indicates that this card is not valid.
0043The card has been reported stolen
0051The credit limit for this account has been exceeded.
0054The card is expired.
1015The 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:

PayPal Navigation

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.