PayPal Name-Value Pair API Developer Guide

API Error Codes

SetExpressCheckout API Errors

Error

Code

15001

Short Message

Gateway Decline

15002 Gateway Decline

15003 Invalid Configuration

15004

15005

15006

15007

15008

Gateway Decline

Processor Decline

Processor Decline

Processor Decline

Invalid Data

Long Message

This transaction cannot be processed.



This transaction cannot be processed. Please enter a valid

Credit Card Verification

Number.


Corrective Action

The transaction was rejected by PayPal because of excessive failures over a short period of time for this credit card.

Contact PayPal for more information.

The transaction was declined by PayPal.

Contact PayPal for more information.

The transaction was declined because the merchant does not have a valid commercial entity agreement on file with PayPal. Contact PayPal for more information.

The transaction was declined because the CVV entered does not match the credit card.

This transaction cannot be processed. Please enter a valid credit card number and type.

This transaction cannot be processed. Please use a valid credit card.

The transaction was declined by the issuing bank, not PayPal. The merchant should attempt another card.

The transaction was declined by the issuing bank, not PayPal. The merchant should attempt another card.

The transaction was declined by the issuing bank because of an expired credit card. The merchant should attempt another card.

This transaction has been completed, but the total of items in the cart did not match the total of all items.

192

SetExpressCheckout API Errors

SetExpressCheckout API Errors

Error

Code Short Message

10001 ButtonSource value truncated.

10001

10003

Internal Error

Missing argument.

Long Message

The transaction could not be loaded

Internal Error

OtherPaymentMethodID is missing.

Correcting This Error...

September 2011

Name-Value Pair API Developer Guide

API Error Codes


Error

Code

10003

10003

10003

10004

10004

10004

10004

10004

10004

10004

10004

Short Message

Missing argument.

Missing argument.

Long Message

OtherPaymentMethodLabel is missing.

OtherPaymentMethodType is missing.

Missing argument.

Transaction refused because of an invalid argument. See additional error messages for details.

One or more of these giropay URLs is missing: giropaySuccessURL, giropayCancelURL,

BanktxnPendingURL.




The transaction id is not valid

Invalid value for request billing address parameter.



Invalid item URL.

OtherPaymentMethodType is invalid.



RegistrationDate of buyer is invalid.

Invalid eBay buyer feedback overall positive count.


Invalid eBay buyer feedback overall negative count.



September 2011

193

194

API Error Codes


Error

Code

10004

10004

10004

10004

10004

10004

10004

10004

10004

10004

Short Message



Long Message

Invalid eBay buyer feedback total positive count.

Invalid eBay buyer feedback total negative count.



Invalid eBay buyer feedback recent positive count.

Invalid eBay buyer feedback recent negative count.



SellerRegistrationDate is invalid.

Invalid eBay seller feedback overall positive count.



Invalid eBay seller feedback overall negative count.

Invalid eBay seller feedback total positive count.



Invalid eBay seller feedback total negative count.

Invalid eBay seller feedback recent positive count.


September 2011


API Error Codes


Error

Code

10004

10004

10004

10004

10004

10004

10005

10005

10005

10007

10010

10101

10102

Short Message



Long Message

Invalid eBay seller feedback recent negative count.

Invalid eBay item transaction date.



Invalid eBay item buyer protection type.

Invalid eBay item payment hold risk.



Option not supported.

Multiple eBay order IDs not allowed.

AllowPushFunding value specified is invalid. It must be 0 or 1 or an empty string.



Permission denied

Merchant not enabled to use enhanced checkout data.

Merchant not enabled to use

OtherPaymentMethodDetails.

Transaction ID is not supported.

You do not have permission to make this API call

Invalid Invoice


PaymentAction of Order

Temporarily Unavailable

Non-ASCII invoice id is not supported.

Express Checkout temporarily unavailable. Please try later.

PaymentAction of Order is temporarily unavailable. Please try later or use other PaymentAction.



September 2011

195

196

API Error Codes


Error

Code

10103

10400

10401

10402

10404

10405

10407

10409

10410

Short Message

Please use another Solution

Type.


Long Message

Your Solution Type is temporarily unavailable. If possible, please use another Solution Type.

OrderTotal is missing.


Authorization only is not allowed for merchant.

Order total is invalid.

This merchant account is not permitted to set PaymentAction to

Authorization. Please contact

Customer Service.

ReturnURL is missing.



CancelURL is missing.


You’re not authorized to access this info.

Invalid token

Invalid buyer email address

(BuyerEmail).

Express Checkout token was issued for a merchant account other than yours.

Invalid token.


September 2011


API Error Codes


Error

Code

10411

10412

10413

Short Message

This Express Checkout session has expired.

Duplicate invoice

Transaction refused because of an invalid argument. See additional error messages for details

Long Message

This Express Checkout session has expired. Token value is no longer valid.

Payment has already been made for this InvoiceID.

The totals of the cart item amounts do not match order amounts.


If you receive this error, you must return your buyer to

PayPal to approve the use of

PayPal again. Display an error message to inform the buyer that the transaction expired, and provide a button to return to PayPal. In this situation, you are effectively restarting the entire checkout process. (Do not reuse the expired token value on

SetExpressCheckout request

.) However, because you already know the final

OrderTotal

, be sure to update the value for that element if appropriate. You might also want to update the values for ReturnURL and

CancelURL

, if necessary.

PayPal checks that

InvoiceID

values are unique for any particular merchant. If you send an InvoiceID value already associated with another transaction in the

PayPal system, PayPal returns error code 10412.

You might not be able to correct this error during an actual checkout. If you receive this error, research why it might occur and modify your implementation of Express

Checkout to ensure that you generate unique invoice identification numbers.

If you receive this error, be sure the total of the payment detail item parameters, such as

ItemTotal, HandlingTotal,

TaxTotal, and so forth add up to the order total.


September 2011

197

198

API Error Codes


Error

Code

10415

10418

10425

10426

10427

10428

10429

10430

10431

Short Message


Long Message

A successful transaction has already been completed for this token.


Express Checkout has been disabled for this merchant.

The currencies of the shopping cart amounts must be the same.

Express Checkout has been disabled for this merchant. Please contact

Customer Service.

Item total is invalid.




Shipping total is invalid.

Handling total is invalid.



Tax total is invalid.

Item amount is missing.


Item amount is invalid.


PayPal allows a token only once for a successful transaction.

If you determine that your buyers are clicking your “Place

Order” button twice, PayPal recommends that you disable the button after your buyer has clicked it.

September 2011


API Error Codes


Error

Code

10432

10433

10434

10436

10437

10438

10439

10440

10441

10442

10446

Short Message



Long Message

Invoice ID value exceeds maximum allowable length.

Value of Order Description has been truncated.




Value of Custom element has been truncated.

PageStyle value exceeds maximum allowable length.


Transaction refused because of an invalid argument. See additional error messages for details. cpp-header-image value exceeds maximum allowable length.

cpp-header-image value exceeds maximum allowable length.


Transaction refused because of an invalid argument. See additional error messages for details. cpp-header-image value exceeds maximum allowable length.

cpp-header-image value exceeds maximum allowable length.


ButtonSource value truncated.


The NotifyURL element value exceeds maximum allowable length.

The ButtonSource element value exceeds maximum allowable length.

Sale is only allowed PaymentAction.


September 2011

199

200

API Error Codes


Error

Code

10457

10458

10459

10460

10461

10462

10463

10464

10465

10467

10468

10469

10470

10471

10472

10473

Short Message

Error occurred in communicating to eBay






Long Message

eBay API creation error eBay API unknown failure eBay API failure

Parsing error

Item number invalid, removed, or unavailable

Order not found




Error occurred in communicating to eBay eBay user password incorrect

Item ID and Transaction ID mismatch eBay user invalid

Duplicate Item ID


PaymentAction of Order

Temporarily Unavailable

Duplicate Order ID

Express Auctions is unavailable

Wowo flag is off for

ExpressO feature


Solution Type passed as Sole while

ExpressO feature is turned off

ReturnURL is missing



CancelURL is missing

Multiple Order IDs are not supported


September 2011


API Error Codes


Error

Code

10474

10475

10476

10477

10478

10479

10480

10537

10538

10539

10725

10727

10728

10729

Short Message

Invalid Data

Long Message


The country code in the shipping address must match the buyer's country of residence

This transaction cannot be completed with PaymentAction of Sale



Invalid Data

Invalid Data

Invalid Data

Invalid Data

Maximum number of billing agreements exceeded

More than one billing agreement specified for reference transaction

Recurring payments profile description must be provided if the billing agreement type is recurring payments

Billing agreement types cannot be mixed in the same request

Invalid Data

Risk Control Country Filter

Failure

Risk Control Max Amount

Failure

Payment declined by your

Risk Controls settings:

PayPal Risk Model.

Shipping Address Country

Error

Shipping Address1 Empty

Shipping Address City

Empty

Shipping Address State

Empty

Invalid billing agreement type

The transaction was refused because the country was prohibited as a result of your Country Monitor Risk

Control Settings.

The transaction was refused because the maximum amount was excceeded as a result of your Maximum

Amount Risk Control Settings.

Payment declined by your Risk

Controls settings: PayPal Risk

Model.

There was an error in the Shipping

Address Country field

The field Shipping Address1 is required

The field Shipping Address City is required

The field Shipping Address State is required


September 2011

201

202

API Error Codes


Error

Code

10730

10731

10736

10800

11001

11001

11001

11001

11001

11001

11001

11068

11547

11601

11602

11801

11802

11803

Short Message

Shipping Address Postal

Code Empty

Shipping Address Country

Empty

Shipping Address Invalid

City State Postal Code

Invalid Data

Exceeds maximum length.







Seller restriction.

Recurring payments temporarily unavailable; try again later

Request for billing address failed

Request for billing address failed

Invalid Data

Invalid Data

Invalid Data

Long Message

The field Shipping Address Postal

Code is required

The field Shipping Address Country is required


A match of the Shipping Address

City, State, and Postal Code failed.

Your request is too long. Check

URLs and other long strings.

Value of NoteText element is truncated.

OtherPaymentMethodID exceeds maximum length.

OtherPaymentMethodLabel exceeds maximum length.

OtherPaymentMethodLabelDescripti on exceeds maximum length.

OtherPaymentMethodLongDescripti on exceeds maximum length.

OtherPaymentMethodLongDescripti onTitle exceeds maximum length.

OtherPaymentMethodIcon exceeds maximum length.

All sellers restricted.

Recurring payments temporarily unavailable.

Billing address request is not enabled for merchant

Feature not yet available

You cannot pass both new and deprecated parameter address fields.

You cannot pass both the new and deprecated Custom parameter.

You cannot pass both the new and deprecated Invoice ID parameter.

September 2011


API Error Codes


Error

Code

11804

11805

11806

11807

11810

11811

11812

11813

11814

11815

Short Message

Invalid Data

Invalid Data

Long Message

You cannot pass both the new and deprecated order description.

You cannot pass both the new and deprecated order total or amount parameters.

Invalid Data

Invalid Data

You cannot pass both the new and deprecated

ProfileAddressChangeDate parameter.

You cannot pass both the new and deprecated ShippingMethod parameter.

Invalid Insurance Amount.



Invalid Shipping Discount.


Invalid Data


The value of Description parameter has been truncated.

Invalid callback URL.

Callback URL is wrong type Callback URL is wrong type; you must use the HTTPS

Invalid data Invalid value for AllowNote.

Item sales tax is invalid.


Callback options missing You must specify callback options when you specify a callback URL

Invalid callback timeout

Line items missing

The callback timeout is is zero; you must specify a longer timeout

Line items are required when specify a callback URL for flate rate shipping options

Ensure that your callback URL starts with https://.


September 2011

203

204

API Error Codes


Error

Code

11821

11822

11823

11824

11825

11826

11827

11828

11829

Short Message

Callback URL is too long

Multiple default shipping options specified

No default shipping option specified

Invalid shipping total

Invalid shipping options

Invalid shipping options

Long Message

The callback URL must not exceed

1,024 characters

You can only specify one default shipping option at a time

You must specify a default shipping option

Invalid shipping total; it should equal the shipping amount of the default shipping option

Invalid shipping options; you must specify a name and amount for each shipping option

Invalid shipping options; you must specify a name and amount for each shipping option type


Multiple default shipping options specified

No default shipping option specified

Invalid callback timeout

Flat-rate shipping options are missing

More than one shipping option type is marked as the default; you can only specify one default shipping option at a time

You must specify one shipping option type as the default

The callback timeout is zero; you must specify a longer timeout value

Flat-rate shipping options are missing; you must specify flat-rate shipping options when you specify a callback URL

Invalid shipping total

Line items missing

Maximum amount of order not specified

Shipping total is missing

Invalid shipping total; it should equal the shipping amount of the selected shipping option

Line items missing; line items are required when you specify a callback

URL for flat-rate shipping options

Maximum amount of order not specified; you must specify the estimated value of the order when using a flat-rate shipping option

Shipping total is missing; you must specify a shipping total when using a flat-rate shipping option

September 2011


API Error Codes


Error

Code

11830

11831

11832

12109

12124

12200

12201

12202

12205

12207

12208

13100

13101

13102

Short Message

Insurance amount is missing Insurance amount is missing; you have offered insurance but have not specified an amount.

Callback URL is too long

Long Message

Callback URL is too long; it must not exceed 1,024 characters


Maximum amount of order is less than itemized amounts


Maximum amount of order is less than itemized amounts; the value of all items, including handling, shipping, tax, and insurance cannot be greater than the maximum amount of the order

Seller blocks payments via eBay checkout for all eBay items.


Buyer ID is not present.

Immediate Payment item was not found.

More than one eBay item is present.

Express Checkout not supported for you.

Buyer ID must be specified to process an Immediate Payment item.

The item specified is either not valid or is not currently available for purchase as an Immediate Payment item.

Please check that the item is a valid Immediate Payment item.

Only one Immediate Payment item can be paid for in a single PayPal payment transaction. eBay Transaction ID and eBay Order ID must be null.

Cart ID is required for

Immediate Payment item. eBay item amount does not match Express Checkout API item amount.

Parallel payments functionality is not available

Invalid Data

Payment Request ID is missing

Requests for eBay Immediate

Payment items should not contain either eBay transaction ID or eBay order ID. If the fields are present, they should contain null values.

Cart ID is required for Immediate

Payment item.

eBay item amount must match

Express Checkout API item amount.

Parallel payments functionality is not available

Payment action of Order is only supported for parallel payments

Payment Request ID is mandatory for parallel payments


September 2011

205

206

API Error Codes


Error

Code

13103

13104

13105

13106

13108

13110

13111

13114

13115

13116

Short Message

Duplicate Payment Request

ID passed

Transaction refused because of an invalid argument. See

Additional error messages for details.

Invalid Data

Long Message

Payment Request ID must be unique for parallel payments

Number of payment requests exceeds maximum number of supported requests.

Invalid Data

Merchant is not eligible.

Multi Payments Sale is Not allowed

Billing Agreement is not supported for parallel payments.

You cannot pass both the new and deprecated PaymentAction parameter.

Merchant is not eligible for parallel payments.

Due to some technical diffculties the

Multi Payments for Sale is not avaliable now please try again later.

Mixed Payment action not supported

Buyer Didn't Complete

The Payment Action passed should be unique, mixed Payment Action not supported

The Buyer returned without completing the payment

Seller ID Missing


Seller ID is mandatory for parallel payments

The transaction is in progress for this token.


September 2011


PayPal Name-Value Pair API Developer Guide

Related manuals

Table of contents

PayPal Name-Value Pair API Developer Guide

Related manuals

PayPal Name-Value

Name-Value Pair API - 2012

PayPal Name-Value

Name-Value Pair API - 2013

PayPal Name-Value

Name-Value Pair API - 2009

PayPal

SOAP API Developer - 2013

PayPal

SOAP API Developer - 2012

PayPal

Pro - 2012

Table of contents