Stripe · Códigos de rechazo
¿Qué significa el error card_declined de Stripe?
Revisado
El código de error de Stripe card_declined significa que la tarjeta ha sido rechazada. Es el error general para cada rechazo de tarjeta: Stripe añade un atributo decline_code que indica el motivo, como insufficient_funds o do_not_honor. Cuando no se devuelve ningún decline_code, el banco no dio ningún motivo. El comprador debería intentar con otra tarjeta o contactar a su banco; la tienda debería leer el decline_code antes de decidir si reintentar.
- Tipo
- Código de error que engloba cada rechazo de tarjeta
- Quién rechazó
- Normalmente el banco de la tarjeta; ver decline_code
- Reintentar
- Depende del decline_code
- Acción del comprador
- Intentar con otra tarjeta o contactar al banco
- Acción del comercio
- Buscar el decline_code para ver el motivo real
- Renovación de PlatformDTC
- Sin decline_code: un reintento 48–72 horas después (Reintento inteligente)
Qué hace PlatformDTC
Cuando solo se devuelve card_declined, la pasarela de pago de PlatformDTC añade "Su tarjeta fue rechazada. Intente con otra tarjeta o contacte a su banco." y, si la tienda tiene pagos con tarjeta de PayPal como respaldo, ofrece un segundo intento allí. Con el Reintento inteligente activado, una renovación con card_declined y sin decline_code se reintenta una vez, 48–72 horas después; un segundo rechazo pide al cliente un nuevo método de pago.
Por qué ocurre
Cada vez que se rechaza un pago con tarjeta, Stripe devuelve card_declined. El motivo específico viaja por separado en el decline_code, que puede ser cualquier cosa, desde un CVC incorrecto hasta una tarjeta perdida.
Si no hay decline_code presente, el banco rechazó sin dar un motivo.
Qué puede hacer el comprador
Verifique los detalles de la tarjeta, luego intente de nuevo o use otra tarjeta. Si la tarjeta sigue fallando, llame a su banco: los bancos explican los rechazos solo al titular de la tarjeta.
Qué puede hacer la tienda
Muestre un mensaje claro y métodos de pago alternativos. En los informes, agrupe los fallos por decline_code en lugar de por card_declined, o cada fallo parecerá el mismo.
Para desarrolladores
error.code = card_declined; el motivo está en error.decline_code (también last_payment_error.decline_code en el PaymentIntent). Lea también charge.outcome.advice_code y network_decline_code. Almacenar solo card_declined pierde la información necesaria para elegir entre un reintento, una solicitud de actualización de tarjeta y una detención.
Preguntas frecuentes
- ¿Cuál es la diferencia entre card_declined y un código de rechazo?
- card_declined es el código de error para cualquier rechazo de tarjeta. El código de rechazo, en el atributo decline_code, explica el motivo.
- ¿Debo reintentar un error card_declined?
- Mire primero el decline_code. Algunos motivos se resuelven con el tiempo, otros significan que la tarjeta nunca funcionará. Sin un decline_code, un reintento espaciado es razonable.
Fuentes
- Códigos de error — Stripe
- Códigos de rechazo de Stripe — Stripe
- Rechazos de tarjeta — Stripe
Relacionado
- generic_decline — Rechazado por una razón desconocida, o bloqueado por Stripe Radar o Adaptive Acceptance.
- do_not_honor — El banco rechazó la tarjeta sin decir por qué.
- insufficient_funds — La tarjeta no tiene suficiente dinero o crédito para este pago.
- call_issuer — El banco rechazó sin una razón y quiere que el titular de la tarjeta lo contacte.
- payment_intent_authentication_failure — La tarjeta falló la verificación de autenticación del banco (como 3-D Secure).
- authentication_required — El banco quiere que el titular de la tarjeta verifique el pago, normalmente con 3D Secure.
- authentication_not_handled — Se requería verificación, el comprador la omitió, y el banco rechazó de nuevo.
- approve_with_id — El banco no pudo autorizar el pago tal como se envió; un intento más podría funcionar.