Entendiendo el error: Entidad no procesable

Cuando su solicitud de pago no se puede completar debido a información incorrecta o violaciones de las reglas comerciales. Los siguientes problemas pueden devolver un error de UNPROCESSABLE_ENTITY.

• Tarjeta vencida
• Id. del formato de pago duplicado
• Pedido ya autorizado
• Pedido ya capturado
• Pedido no aprobado
• Redirija al pagador para obtener fondos alternativos
• Tarjeta referenciada vencida
• La dirección de envío no es válida
• No se ha encontrado el Id. del token

Nota: Si el problema persiste o si tienes más preguntas, puedes comunicarte con paypal-techsupport.com.

Tarjeta vencida

Devoluciones de las API de Pedidos de PayPal v2 o Pagos v1. Consulte el documento para desarrolladores Card Expired .

Causa:
este error ocurre cuando un cliente intenta pagar con una tarjeta de crédito o débito que ha pasado su fecha de vencimiento. Una tarjeta vencida no se puede utilizar para ninguna compra.

Impacto
: el pago se detiene inmediatamente y el cliente no puede completar la compra. Si no se aborda rápidamente, podría perder la venta.

Centro de resoluciones

• Muestre al cliente un mensaje explicándole que su tarjeta ha vencido.
• Ayúdelos a ingresar una tarjeta diferente a través de PayPal o PayPal Commerce Platform.
• Proporcione instrucciones simples para cambiar a otra forma de pago y completar su compra.

Id. del formato de pago duplicado

Devoluciones de las API Pagos v1 o Pedidos v2. Consulte el documento para desarrolladores Id. de factura duplicada.

Causa
: PayPal detecta un id. de formato de pago duplicado. Cada transacción necesita un formato de pago_id único para evitar transacciones duplicadas. Esto suele ocurrir cuando se utiliza el mismo número de pedido para varias transacciones.

Impacto
El proceso de pago se detiene, lo que impide que el cliente complete su compra. Esto puede llevar a la pérdida de ventas.

Solución
: Utilice un número de identificación del formato de pago diferente para cada transacción. Si necesita utilizar el mismo Id. del formato de formato de pago varias veces, póngase en contacto con el Servicio de Asistencia de PayPal. Considere configurar notificaciones instantáneas de pago (IPN) o webhooks para obtener actualizaciones en tiempo real sobre las transacciones.

Pedido ya autorizado

Devoluciones de las API Pagos v2 o Pedidos v2. Consulte el documento Pedido de desarrollador ya autorizado .

Causa
El pedido ya fue autorizado a través de una solicitud anterior. Cuando se crea un pedido con intent="AUTHORIZE", solo se permite una autorización. Se rechazará un segundo intento. Esto podría suceder si accidentalmente envió la misma solicitud dos veces o si no vio que la primera solicitud se realizó correctamente.

Impacto
: No hay ningún impacto en la autorización original. Solo se rechaza el segundo intento. No puede autorizar un importe parcial ahora y autorizar el resto más adelante.

Resolución
Autoriza el importe total en una sola solicitud y, a continuación, crea varias capturas según sea necesario. Cree varias capturas configurando final_capture="false" en sus solicitudes de captura. Esto es útil para envíos divididos. Considere integrar webhooks de PayPal para recibir automáticamente actualizaciones sobre el estado del pedido. Si las llamadas de API están tardando demasiado, póngase en contacto con el soporte técnico de PayPal.

Pedido ya capturado

Devoluciones de la API Pedidos v2. Consulte el documento para desarrolladores Order Already Captured .

Porque
el pedido de PayPal ya está en estado "capturado", lo que significa que el pago se completó y los fondos se han transferido a su cuenta. No se pueden crear nuevas capturas en este pedido. Esto sucede si usas intent="SALE", que solo permite una captura por pedido, o si tu sistema no registró el éxito del primer intento de captura y vuelve a intentarlo.

Impacto
Si solo capturó una parte del importe del pedido, no podrá capturar el importe restante a menos que cree un nuevo pedido de PayPal. No hay ningún impacto para su cliente si solo tenía la intención de tener una captura, pero su sistema podría no estar sincronizado con los registros de PayPal.

Resolución Si desea realizar varias capturas, utilice intent="AUTHORIZE" en lugar de intent="SALE".
Esto crea una autorización primero y permite varias capturas después. Asegúrate de que el parámetro de final_capture esté establecido en false en tu llamada de pago API de captura autorizada para permitir capturas adicionales. Utilice un nvoice_id iúnico para cada captura. Realice un seguimiento de las respuestas correctas de la API para evitar llamadas duplicadas. Considere utilizar webhooks de PayPal para recibir actualizaciones automáticas acerca de cambios en el estado de los pagos.

Pedido no aprobado

Devoluciones de las API Pagos v1 o Pedidos v2. Consulte el documento para desarrolladores Order Not Approved .

Causa
: su cliente inició pero no completó el proceso de pago de PayPal o puede faltar información de pago requerida en la solicitud.

Impacto
: el pago se rechaza y no se procesa, lo que provoca retrasos en la compra.

Resolución
Asegúrese de que su cliente sea redireccionado a la URL "rel":"aprobar" que PayPal proporciona cuando crea un pedido. Esto los lleva al flujo de pago de PayPal para aprobar el pago. Asegúrese de que su solicitud incluya toda la información de pago requerida.

Beneficiario no habilitado para el procesamiento de tarjetas

Devoluciones de la API Pedidos v2. Consulte el documento para desarrolladores Beneficiario no habilitado para el procesamiento de tarjetas.

Causa
: Este error aparece cuando tu cuenta no está configurada para aceptar pagos con tarjeta de crédito/débito. El pago no se completará hasta que habilite los pagos con tarjeta en su cuenta. Este error también puede aparecer si no has completado todos los pasos para aceptar pagos con PayPal Complete Payments.

Impacto
: tus clientes no pueden completar sus compras cuando intentan pagar con tarjeta. Esto podría provocar pérdidas de ventas si no se soluciona rápidamente. Esto afecta a todos los clientes que intentan pagar con tarjeta, no solo a una persona.

Resolución
: Asegúrese de haber completado todos los pasos de configuración requeridos. Si estás utilizando Pagos Completos de PayPal, intenta pasar por el proceso de configuración nuevamente y asegúrate de seleccionar la opción para pagos con tarjeta. Si el problema persiste, comuníquese con el Servicio de Asistencia Técnica de PayPal . Si otra persona administra la configuración de tu cuenta de PayPal, pídele que se comunique directamente con PayPal para habilitar los pagos con tarjeta en tu cuenta.

Redirija al pagador para obtener fondos alternativos

Devoluciones de las API Pagos v1 o Pedidos v2. Consulte el documento para desarrolladores Redirect Payer For Alternate Funding .

Causa
: este error aparece cuando el método de pago elegido por el cliente en su cartera de PayPal tiene un problema.

Impacto
: tus clientes no pueden completar sus compras cuando intentan pagar con tarjeta. Esto podría provocar pérdidas de ventas si no se soluciona rápidamente. Esto afecta a todos los clientes que intentan pagar con tarjeta, no solo a una persona.

Centro de resoluciones

• Muéstrale al cliente un mensaje explicándole que su pago no se realizó y que debe elegir otra forma de pago.
• Dirígelo de nuevo al Pago de PayPal para que pueda seleccionar otra opción de pago.
• Si los problemas continúan, sugiérele que intente pagar con una tarjeta de crédito en su lugar.
• Si el cliente aún enfrenta problemas, recomiéndele que se comunique directamente con PayPal acerca de su cuenta.
• Utiliza instrucciones sencillas y claras para que el cliente pueda completar la compra sin problemas.

Tarjeta referenciada vencida

Devoluciones de las API Orders v2 o Vault v3. Consulte el documento para desarrolladores Tarjeta vencida a la que se hace referencia.

Causa
Este error se produce cuando un comprador intenta pagar con una tarjeta de crédito o débito guardada, pero la tarjeta registrada ha vencido. Debido a esto, el pago no se puede procesar. El comprador deberá utilizar una tarjeta diferente o elegir otro método de pago para finalizar la compra.

Impacto
: el pago se detiene y el comprador no puede completar el pedido. Si esto no se soluciona rápidamente, podría perder la venta.

Centro de resoluciones

• Habilitar el actualizador de cuentas en tiempo real (RTAU): Si está utilizando Pagos Completos de PayPal con tarjetas de crédito y débito avanzadas, active el Actualizador de cuenta en tiempo real (RTAU). Esta función actualiza automáticamente las tarjetas guardadas de sus clientes con nuevas fechas de vencimiento cada vez que se renuevan sus tarjetas, lo que ayuda a evitar errores con tarjetas vencidas.
  • RTAU para comercios directos
  • RTAU para varias partes
• Muestre claramente el mensaje de error: Informe a su cliente que su tarjeta guardada ha vencido.
• Actualice el token de pago guardado: Cuando recibas un nuevo token de pago del cliente, actualízalo en tu sistema. Asegúrese de eliminar el token antiguo y caducado de sus registros y de la bóveda de PayPal.
• Dar instrucciones claras y sencillas a tu cliente le ayudará a completar el pago con facilidad, reduciendo la posibilidad de que abandone la compra.

La dirección de envío no es válida

Devoluciones de las API Pagos v1 o Pedidos v2. Consulte el documento para desarrolladores Dirección de envío no válida .

Motivo
Es posible que el cliente haya omitido campos importantes de la dirección, como la dirección, la ciudad o el estado. Es posible que el formato de la dirección sea incorrecto o que el sistema no envíe correctamente la dirección completa en la solicitud.

Impacto
: el cliente no puede completar la compra, lo que podría provocar la pérdida de una venta si no se soluciona rápidamente.

Solución: Agregue
la validación del formulario para asegurarse de que todos los campos de dirección obligatorios se completen correctamente antes de enviarlos. Considere la posibilidad de utilizar herramientas de validación de direcciones para asegurarse de que las direcciones sigan el formato correcto. Revise sus sistemas para asegurarse de que toda la información de la dirección se capture correctamente y se incluya en sus solicitudes.

No se ha encontrado el Id. del token

Devoluciones de las API de Pagos v1 o Pedidos v2.Consulta el documento para desarrolladores Token ID Not Found .

Causa:
este error ocurre cuando PayPal no puede reconocer el ID de token proporcionado durante el pago. Las razones comunes son que el token puede tener un error tipográfico o que la cuenta que realiza la solicitud no tenga el permiso adecuado para usar el token.

Impacto
Cuando ocurre este error, el proceso de pago se detiene y el cliente no puede completar la compra. Si esto no se soluciona rápidamente, podría provocar una pérdida de ventas.

Resolución: Verifique
los permisos para asegurarse de que la cuenta de PayPal correcta haya otorgado los permisos necesarios. Además, revise el código para confirmar que el identificador del token no se ha cambiado accidentalmente. Si el token no es válido o ha caducado, cree uno nuevo y utilícelo en su solicitud.