Dois-je réessayer INSTRUMENT_DECLINED ?

Au moment du paiement, redémarrez afin que l'acheteur puisse choisir une autre source de financement, comme le recommande PayPal. Pour les abonnements, des réessais espacés donnent à la carte ou au solde de l'acheteur le temps de se reconstituer, car PayPal ne mentionne aucune raison qui exclurait la récupération.

INSTRUMENT_DECLINED signifie-t-il que le compte PayPal de l'acheteur est bloqué ?

Non. Il s'agit de la carte ou de la banque spécifique qu'ils ont choisie. PayPal utilise d'autres erreurs, telles que PAYER_ACCOUNT_LOCKED_OR_CLOSED, pour les problèmes de compte.

PayPal · Codes de refus

Que signifie l'erreur PayPal INSTRUMENT_DECLINED ?

Vérifié le 31 octobre 2026

L'erreur INSTRUMENT_DECLINED de PayPal signifie que la source de financement choisie par l'acheteur, une carte ou un compte bancaire dans son portefeuille PayPal, a été refusée par le processeur ou la banque, ou ne peut pas être utilisée pour ce paiement. PayPal énumère des causes telles qu'une adresse de facturation incorrecte, une carte dépassant sa limite, ou un refus bancaire. La solution est de redémarrer le paiement afin que l'acheteur puisse choisir une autre source de financement.

Description PayPal: L'instrument présenté a été soit refusé par le processeur ou la banque, soit il ne peut pas être utilisé pour ce paiement.
Type: Refus souple
Qui a refusé: Le processeur ou la banque derrière la source de financement PayPal
Réessayer: Oui, quelques jours plus tard ; changez de méthode si cela se répète
Action de l'acheteur: Choisissez une autre carte ou banque dans PayPal et payez à nouveau
Action du commerçant: Redémarrez le paiement afin que l'acheteur puisse choisir une autre source
Renouvellement PlatformDTC (Smart retry): Échelle PayPal : jusqu'à 7 tentatives, espacées de 3 jours ou plus, visant le jour de paie

Ce que fait PlatformDTC

PlatformDTC traite INSTRUMENT_DECLINED comme un refus PayPal générique. Avec Smart retry activé, un renouvellement d'abonnement PayPal refusé de cette manière suit l'échelle PayPal plus longue : jusqu'à 7 tentatives, chacune au moins 3 jours après la précédente, déplacées au prochain jour de paie de l'abonné si l'un tombe dans la semaine, dans une fenêtre d'au moins 24 jours. Lorsque les tentatives de réessai sont épuisées, l'abonnement est mis en retard, non annulé. Pour les paiements par carte PayPal, tout code de processeur que PlatformDTC ne mappe pas est également enregistré comme INSTRUMENT_DECLINED, avec le code brut conservé.

Pourquoi cela arrive

PayPal renvoie cela lorsque la source de financement du payeur échoue : la carte ou la banque dans son portefeuille PayPal a dit non. Le guide de PayPal sur les échecs de financement cite comme exemples une adresse de facturation incorrecte, une transaction dépassant la limite de la carte et un refus de l'émetteur de la carte.

Ce que l'acheteur peut faire

Retournez dans PayPal et choisissez une carte, un compte bancaire ou votre solde PayPal différent.

Ou vérifiez l'adresse de facturation et la limite de la carte, puis réessayez.

Ce que le magasin peut faire

Redémarrez le flux de paiement afin que l'acheteur revoie les choix de financement de PayPal ; ne vous contentez pas d'afficher une erreur.

Lors des renouvellements, espacez les réessais sur plusieurs jours ; le solde de l'acheteur pourrait se reconstituer d'ici le jour de paie.

Pour les développeurs

Lorsque vous capturez depuis votre serveur et que l'API Orders renvoie INSTRUMENT_DECLINED (dans details[0].issue du corps de l'erreur), redémarrez le paiement : dans le SDK JavaScript, appelez actions.restart() à l'intérieur de onApprove. PayPal indique que le redémarrage est requis si vous appelez l'API Orders directement depuis votre serveur.

Si vous capturez avec actions.order.capture() dans le navigateur, le script de PayPal redémarre automatiquement le flux de paiement et invite le payeur à choisir une autre source de financement.

Questions fréquentes

Dois-je réessayer INSTRUMENT_DECLINED ?: Au moment du paiement, redémarrez afin que l'acheteur puisse choisir une autre source de financement, comme le recommande PayPal. Pour les abonnements, des réessais espacés donnent à la carte ou au solde de l'acheteur le temps de se reconstituer, car PayPal ne mentionne aucune raison qui exclurait la récupération.
INSTRUMENT_DECLINED signifie-t-il que le compte PayPal de l'acheteur est bloqué ?: Non. Il s'agit de la carte ou de la banque spécifique qu'ils ont choisie. PayPal utilise d'autres erreurs, telles que PAYER_ACCOUNT_LOCKED_OR_CLOSED, pour les problèmes de compte.

Sources

Erreurs de l'API Orders v2 — PayPal
Gérer les échecs de financement — PayPal
Référence de l'API Orders v2 — PayPal