¿Debo reintentar INSTRUMENT_DECLINED?

En el proceso de pago, reinicia para que el comprador pueda elegir otra fuente de financiación, como recomienda PayPal. Para las suscripciones, los reintentos espaciados dan tiempo a la tarjeta o al saldo del comprador para recuperarse, ya que PayPal no menciona ninguna razón que descarte la recuperación.

¿Es INSTRUMENT_DECLINED que la cuenta de PayPal del comprador está bloqueada?

No. Se trata de la tarjeta o el banco específico que eligieron. PayPal utiliza otros errores, como PAYER_ACCOUNT_LOCKED_OR_CLOSED, para problemas de cuenta.

PayPal · Códigos de rechazo

¿Qué significa el error PayPal INSTRUMENT_DECLINED?

Revisado 31 de octubre de 2026

El error INSTRUMENT_DECLINED de PayPal significa que la fuente de financiación que el comprador eligió, una tarjeta o cuenta bancaria en su cartera de PayPal, fue rechazada por el procesador o el banco, o no se puede usar para este pago. PayPal enumera causas como una dirección de facturación incorrecta, una tarjeta que excede su límite o una denegación bancaria. La solución es reiniciar el pago para que el comprador pueda elegir otra fuente de financiación.

Descripción de PayPal: El instrumento presentado fue rechazado por el procesador o el banco, o no se puede usar para este pago.
Tipo: Rechazo suave
Quién rechazó: El procesador o banco detrás de la fuente de financiación de PayPal
Reintentar: Sí, unos días después; cambia de método si se repite
Acción del comprador: Elige otra tarjeta o banco en PayPal y paga de nuevo
Acción del comercio: Reinicia el pago para que el comprador pueda elegir otra fuente
Renovación de PlatformDTC (Smart retry): Escalera de PayPal: hasta 7 intentos, con 3 o más días de diferencia, con el objetivo de la fecha de pago

Qué hace PlatformDTC

PlatformDTC trata INSTRUMENT_DECLINED como un rechazo genérico de PayPal. Con Smart retry activado, una renovación de suscripción de PayPal rechazada de esta manera sigue la escalera más larga de PayPal: hasta 7 intentos, cada uno al menos 3 días después del anterior, movidos a la próxima fecha de pago del suscriptor cuando una cae dentro de una semana, dentro de una ventana de al menos 24 días. Cuando se agotan los reintentos, la suscripción se mantiene como vencida, no se cancela. En los pagos con tarjeta de PayPal, cualquier código de procesador que PlatformDTC no mapee también se registra como INSTRUMENT_DECLINED, manteniendo el código original.

Por qué sucede

PayPal devuelve esto cuando falla la fuente de financiación del pagador: la tarjeta o el banco dentro de su cartera de PayPal dijo que no. La guía de fallos de financiación de PayPal enumera como ejemplos una dirección de facturación incorrecta, una transacción que excede el límite de la tarjeta y una denegación del emisor de la tarjeta.

Qué puede hacer el comprador

Vuelve a PayPal y elige una tarjeta, cuenta bancaria o tu saldo de PayPal diferente.

O verifica la dirección de facturación y el límite de la tarjeta, luego inténtalo de nuevo.

Qué puede hacer la tienda

Reinicia el flujo de pago para que el comprador vea de nuevo las opciones de financiación de PayPal; no solo muestres un error.

En las renovaciones, espacia los reintentos a lo largo de los días; el saldo del comprador puede recuperarse para la fecha de pago.

Para desarrolladores

Cuando capturas desde tu servidor y la API Orders devuelve INSTRUMENT_DECLINED (en `details[0].issue` del cuerpo del error), reinicia el pago: en el SDK de JavaScript, llama a `actions.restart()` dentro de `onApprove`. PayPal dice que reiniciar es necesario si llamas a la API Orders directamente desde tu servidor.

Si capturas con `actions.order.capture()` en el navegador, el script de PayPal reinicia el flujo de pago automáticamente y solicita al pagador que elija otra fuente de financiación.

Preguntas frecuentes

¿Debo reintentar INSTRUMENT_DECLINED?: En el proceso de pago, reinicia para que el comprador pueda elegir otra fuente de financiación, como recomienda PayPal. Para las suscripciones, los reintentos espaciados dan tiempo a la tarjeta o al saldo del comprador para recuperarse, ya que PayPal no menciona ninguna razón que descarte la recuperación.
¿Es INSTRUMENT_DECLINED que la cuenta de PayPal del comprador está bloqueada?: No. Se trata de la tarjeta o el banco específico que eligieron. PayPal utiliza otros errores, como PAYER_ACCOUNT_LOCKED_OR_CLOSED, para problemas de cuenta.