Payments · Guide9 min readUpdated November 3, 2026

PayPal Declined Payments: Codes and Fixes

PayPal declined your customer's payment? Who said no, what INSTRUMENT_DECLINED, 0500, 10486 and other codes mean, and what to do for each one.

Nick Bonnassies, CMO at Tagada · checked against 10 sources

Article summary

TL;DR

Most PayPal declines come from the buyer's bank or the buyer's PayPal account, not from your store. PayPal's checkout returns a code such as INSTRUMENT_DECLINED: restart the flow so the buyer picks another funding source. Some declines are yours: payment receiving preferences that block buyers, a payment under review, or a limited account.

PayPal's developer guide says to answer INSTRUMENT_DECLINED by prompting "the buyer to select a different payment method" and restarting the flow with `actions.restart()`.
Card declines carry a processor code, such as 0500 for DO_NOT_HONOR, among 154 values in PayPal's Orders v2 API.
Visa's payment advice code 02 means the cardholder stopped one recurring payment: "The merchant must NOT resubmit the same transaction".
Your own preferences can block buyers without a confirmed address, in other countries, or paying in a currency you don't hold.
Visa allows up to 20 reattempts in 30 days, and none after a category 1 decline.

Want to go further? Ask

On this page

This page covers PayPal's codes and tools. For Visa's two-digit codes and retry categories at any processor, see declined payments: decline codes and retry rules. More PayPal guides are in the PayPal hub.

Who declined the payment

Four parties can say no on a PayPal payment. The code tells you which one, and that tells you what to do.

Who said no	Typical sign	Example codes	What to do
The buyer's bank or card issuer	Card refused, often for funds or verification5	INSTRUMENT_DECLINED, TRANSACTION_REFUSED, 0500, 104861 2 3	Let the buyer choose another funding source1
The buyer's PayPal account	Account locked, inactive or unable to pay1	INVALID_ACCOUNT_STATUS, PAYER_CANNOT_PAY, 131131 4	Buyer contacts PayPal; offer another method1 4
PayPal's risk checks	Payment denied, or held for review1 7	PAYMENT_DENIED; a notice to delay shipping1 7	Don't ship; investigate, contact PayPal if needed1
Your own account or settings	Blocked by your preferences, or your account is limited6	Varies	Check preferences and the Resolution Center6

Fig. 1Read the decline before you retry

INSTRUMENT_DECLINEDThe funding source failedRestart the flow so the buyer picks another one
PAYMENT_DENIEDPayPal refused the paymentDon't retry the same way; ask for another method
Code 02 or 03 on a renewalThe cardholder stopped recurring paymentsStop the retries; contact the customer
Many buyers blocked from one countryYour receiving preferencesReview the block settings in your account

only some of them are worth a second try

Based on PayPal Developer docs and PayPal Help Center (US), read November 3, 2026.

PayPal checkout codes (Orders v2)

If you use PayPal's current checkout, the Orders v2 API returns a named error. Here are the ones tied to declines, with PayPal's own guidance1.

Code	What PayPal says it means	What PayPal says to do
INSTRUMENT_DECLINED	"Payment method was declined."	Prompt another payment method; restart with `actions.restart()`
CARD_EXPIRED	"Card is expired."	Ask for a new card
REDIRECT_PAYER_FOR_ALTERNATE_FUNDING	"Funding source failed, alternate source needed."	Prompt another payment method
PAYER_CANNOT_PAY	"The payer is unable to pay using the selected payment method."	Another method, or the buyer contacts PayPal
TRANSACTION_REFUSED	"The transaction was refused by the processor."	Another method, or the buyer contacts the bank
PAYMENT_DENIED	"The payment was denied by PayPal."	Investigate; contact PayPal support if needed
MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED	"Too many failed attempts."	Another method, or PayPal support
INVALID_ACCOUNT_STATUS	The payer's account is "locked or inactive"	Buyer contacts PayPal support

Restarting matters. actions.restart() "restarts the payment flow so the buyer can select a different funding source"1, instead of sending them back to an empty cart. Some failures arrive later: PayPal recommends webhooks such as PAYMENT.CAPTURE.DENIED to catch them1.

Card decline codes on PayPal

When a card is charged through PayPal's card fields, the response includes a processor_response. Two fields matter2.

Fig. 2Three layers of a PayPal card decline

response_code
The processor's answer, such as 0500 DO_NOT_HONOR or 0580 UNAUTHORIZED_TRANSACTION.
payment_advice_code
Visa's or Mastercard's instruction: retry later, update the card, or stop.
cvv_code and avs_code
Whether the security code and address matched.

read them in this order

PayPal Developer, Orders v2 processor_response definition, read November 3, 2026.

Examples of response_code values PayPal lists2:

0000 APPROVED
00N7 CVV2_FAILURE_POSSIBLE_RETRY_WITH_CVV
0100 REFERRAL
0390 ACCOUNT_NOT_FOUND
0500 DO_NOT_HONOR
0580 UNAUTHORIZED_TRANSACTION

The payment_advice_code is the one that tells you whether to retry. PayPal relays the networks' wording2:

Advice code	Visa	Mastercard
02	Cardholder stopped one recurring payment: "The merchant must NOT resubmit the same transaction"	"Over credit limit or insufficient funds. Retry the transaction 72 hours later."
03	Cardholder stopped all recurring payments: "Stop recurring payment requests."	"Account closed as fraudulent." Get another payment method
21	"All recurring payments were canceled for the card number requested."	Cardholder couldn't cancel through the merchant: stop requests
24 to 29	Not used by Visa	Retry after 1 hour, 24 hours, 2, 4, 6 or 8 days

A Visa 02 still lets you bill the next period; a 03 or 21 doesn't2. Treat them as cancellations, not as failed cards.

Older integrations: NVP and Express Checkout codes

Classic integrations return five-digit codes. Two common ones3 4:

10486: "A buyer's PayPal Express Checkout payment failed due to a card-issuing bank denial", for example the card limit. PayPal's fix: send the buyer back to PayPal to choose or add another funding source, which avoids "a checkout loop"3.
13113: "The buyer's payment method was denied, or they can't make a payment due to an issue with their account"4. The buyer needs to sort it out with PayPal.

PayPal's general advice for a card it refused: if the customer has the card in their PayPal account, invoice them or use a PayPal account payment flow; otherwise ask for another card. If the bank needs to verify, "the customer must contact the bank for approval"5.

Declines you caused yourself

Check your side before blaming the bank. Three causes sit in your account.

Payment receiving preferences. A Business account can block payments automatically6:

from customers who don't have a confirmed address;
sent in a currency you don't hold;
for duplicate invoice IDs;
from customers in other countries.

If buyers from one country all fail, start here. The setting is under your account's payment preferences6.

Payment review. When PayPal judges a transaction high-risk, it holds it and asks you "to delay shipping", then completes or cancels it7. A cancelled review looks like a decline to the buyer. See PayPal money on hold.

A limited account. A limitation can stop parts of your account until you complete PayPal's steps7. See PayPal account limited.

Example

A US store starts selling to Canada and sees every Canadian PayPal payment fail. The bank isn't involved: "Block payments from customers in other countries" is switched on6. Illustrative case.

Retrying without breaking the rules

Fewer retries than you think. Braintree, PayPal's card platform, notes that repeated attempts inflate your decline ratio and that Visa and Mastercard now charge fees for excessive retries8. It calls "about 10% of your transactions" an acceptable decline ratio, depending on industry8.

Visa: up to 20 reattempts in 30 days for categories 2 to 4, and none after a category 1 decline such as a lost, stolen or closed account9.
Don't alter the request to force it through. Visa's rules say a merchant that reattempts "must not intentionally manipulate any data elements from the original Authorization Request"9.
PayPal subscriptions have their own retries: PayPal "uses a proprietary algorithm to determine the best time to retry the payment", and you can retry manually from the dashboard or the API1.
Another processor doesn't reset the count. A card declined on PayPal and charged again elsewhere is still a reattempt for Visa9.

Tagada follows Visa and Mastercard rules and the laws that apply to payments. Spacing and schedules: smart retries. Failed renewals: subscription payment failures.

What to tell the customer

Keep it short and give them a way to pay. PayPal's guidance boils down to four messages1 4 5:

"Your payment method was declined. Please try another one." Then restart the PayPal flow1.
"Your bank may need to approve this payment." For verification declines5.
"Please check your PayPal account or contact PayPal." For account issues such as 131134.
Offer another way to pay, such as a card form next to the PayPal button.

Never ask a buyer to pay you as "friends and family" to get around a decline: PayPal's agreement forbids it for sales7.

By industry

Industry	What changes	Guide
Supplements	Big bundles and renewals on cards that changed	Reducing payment declines for supplement brands
Skincare	Wallets and a clear descriptor matter more	Reducing payment declines for skincare brands
Fitness	Annual plans and equipment orders hit card limits	Reducing payment declines for fitness brands
Info products	High-ticket courses and payment plans	Reducing payment declines for info product businesses
Online pharmacy	Refill renewals and card updates	Reducing payment declines for online pharmacies
Telehealth	Memberships and health-account cards	Reducing payment declines for telehealth companies

How Tagada helps

Another route when a payment is declined

Acceptance: "If you sell something real, we will get you paid."10
Routing: "Route to the processor most likely to approve it, retry on decline. No engineering required."10
Cascade: "Automatic cascade, weighted routing, sticky MID". TagadaPay reports a "+18% approval uplift"10. The cascade goes to another processor when one is down or times out.
Fraud and security: "Native 3DS2, device intelligence, and rules engine: approve real customers, block the rest."10
Payment methods: TagadaPay lists "40+ Local payment methods"10.

A category 1 decline stays final on every route. Tagada CRM plans are on the pricing page.

Apply today · Go live in under 24 hours

Apply for processing

Another route when a payment is declined

Updated on November 3, 2026

Nick Bonnassies

CMO at Tagada

CMO at Tagada. Before Tagada, Nick built direct-to-consumer brands that generated over $115M in sales, raised over $25M in crowdfunding and sold two of them. He also works as a fractional CMO on marketing operations and AI systems.

Frequently asked questions

Why is my customer's PayPal payment declined?

Usually the buyer's bank refused the card, often for funds or verification, or the buyer's PayPal account can't pay. Less often, PayPal denied it on risk, or your own receiving preferences blocked it, for example payments from other countries. The error code tells you which: INSTRUMENT_DECLINED points to the funding source.

What does INSTRUMENT_DECLINED mean on PayPal?

The buyer's payment method was declined. PayPal's developer guide says to prompt the buyer to choose a different payment method and restart the flow with actions.restart(), so they stay in checkout instead of starting over. It's a funding failure, not a problem with your integration.

What is PayPal error 10486?

It's a classic Express Checkout error: the buyer's card-issuing bank denied the payment, for example because it exceeded the card limit. PayPal recommends sending the buyer back to PayPal to pick or add another funding source, which avoids a new SetExpressCheckout call and a checkout loop.

Can I retry a declined PayPal payment?

Sometimes. Retry soft declines a few times, spaced out. Stop when Visa's advice code is 02 for that payment, or 03 or 21 for all recurring payments. Visa allows up to 20 reattempts in 30 days and none after a category 1 decline. PayPal Subscriptions retries renewals with its own algorithm.

Why does PayPal block payments from other countries to my account?

Check your Payment Receiving Preferences. A Business account can automatically block payments from customers in other countries, from buyers without a confirmed address, in currencies you don't hold, and for duplicate invoice IDs. Change the setting in your account's payment preferences.

Sources

Checked November 3, 2026

TagadaPay

Declines on PayPal? Add a card route that retries within the rules

Tell us what you sell and how you sell it. Each application is underwritten, and approval is not guaranteed.

Apply for processing See pricing

01Tell us what you sell and how
02Underwriting reviews your business
03Process through TagadaPay alongside your other processors