PayPal · Códigos de rechazo
¿Qué significa el error PayPal PAYER_ACTION_REQUIRED?
Revisado
El error PAYER_ACTION_REQUIRED de PayPal significa que el pago no puede completarse hasta que el comprador realice una acción; la instrucción de PayPal es "indicar al comprador que regrese a PayPal". Reenviar sin el comprador fallará de nuevo, así que envíalos de vuelta a PayPal. En una suscripción de PayPal guardada, el comprador no está presente, por lo que la tienda tiene que traerlo de vuelta.
- Descripción de PayPal
- La transacción no puede completarse con éxito, indica al comprador que regrese a PayPal.
- Tipo
- Acción del comprador necesaria
- Quién rechazó
- PayPal
- Reintentar
- Solo después de que el comprador complete el paso en PayPal
- Acción del comprador
- Regresa a PayPal y completa el paso mostrado
- Acción del comercio
- Envía al comprador de vuelta a PayPal; no reenvíes a ciegas
- Renovación de PlatformDTC
- No reintento ciego; se le pidió al cliente que confirmara con su banco
Qué hace PlatformDTC
PlatformDTC trata PAYER_ACTION_REQUIRED como un pago que requiere la acción del cliente. En cualquiera de los programas de reintento (el programa predeterminado Fixed schedule o Smart retry), una renovación rechazada de esta manera nunca se reintenta ciegamente, porque no hay nadie para responder: la suscripción se mantiene vencida y el cliente recibe un correo electrónico pidiéndole que confirme el pago, además de un enlace de un solo clic firmado para solucionarlo, reenviado hasta 4 veces por ciclo de facturación.
¿Por qué sucede?
PayPal necesita algo del comprador antes de poder finalizar: una aprobación o un paso de verificación.
Qué puede hacer el comprador
Vuelva a abrir PayPal desde la caja o el correo electrónico que recibió y complete el paso que se muestra.
Qué puede hacer la tienda
Redirija al comprador al enlace de aprobación de PayPal en lugar de reintentar.
Para suscripciones, envíe un correo electrónico al cliente: solo ellos pueden completar el paso.
Para desarrolladores
El problema aparece en `details[0].issue`. En `Orders v2`, un pedido o token de configuración de bóveda también puede estar en estado PAYER_ACTION_REQUIRED con un enlace de acción del pagador en su `links array`; envíe al comprador allí y capture después de que regrese.
Preguntas frecuentes
- ¿Por qué una renovación no puede completar PAYER_ACTION_REQUIRED por sí misma?
- Porque la acción le corresponde al comprador. Reintentar sin ellos devuelve el mismo error.
- ¿Es PAYER_ACTION_REQUIRED un rechazo?
- No es una denegación de fondos; es una pausa hasta que el comprador actúe.
Fuentes
- Errores de la API de Orders v2 — PayPal
- Referencia de la API de Orders v2 — PayPal
Relacionado
- INSTRUMENT_DECLINED — Instrumento rechazado: la tarjeta o el banco en el PayPal del comprador fue rechazado.
- PAYER_CANNOT_PAY — El pagador no puede pagar: la configuración de PayPal de este comprador y de este vendedor no permite el pago.
- 5650 — SCA requerido: el banco necesita que el titular de la tarjeta autentique el pago.
- TRANSACTION_REFUSED — Transacción rechazada: PayPal rechazó la solicitud sin una razón específica.
- PAYEE_ACCOUNT_RESTRICTED — Cuenta del beneficiario restringida: la cuenta de PayPal del comercio está restringida.
- PAYER_ACCOUNT_LOCKED_OR_CLOSED — Cuenta del pagador bloqueada o cerrada: la cuenta de PayPal del comprador no se puede usar.
- COMPLIANCE_VIOLATION — Violación de cumplimiento: PayPal rechazó el pago por motivos de cumplimiento.
- MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED — Máximo de intentos de pago excedido: demasiados intentos en este pedido.