Motivos de rechazo de pago
Cada mensaje de error que ve el comprador en el checkout, qué quiere decir y qué puedes hacer en la tienda para resolverlo.
Cuando un pago no pasa, el checkout abre una ventana con el título "No pudimos completar tu pago", un mensaje corto y el botón "Corregir e intentar de nuevo". Los datos que escribió el comprador siguen en el formulario.
Los mensajes de esta página son los del checkout en español. El comprador lee el mismo mensaje en el idioma de su checkout. La página pago en análisis o rechazado explica el mismo tema para el comprador.
Dónde ver el motivo real
El checkout nunca le muestra al comprador el código técnico del proveedor. Para saber qué pasó:
- Abre VentasTransacciones y haz clic en el pedido con estado Fallido.
- En la tarjeta Intentos de pago, cada fila es una llamada a una cuenta de pago. La columna Error muestra el código y el mensaje que devolvió el proveedor, en inglés.
Un rechazo antes de que exista el pedido, como un cupón inválido o una dirección fuera del área de entrega, no genera pedido. En esos casos, el motivo es el propio mensaje que ve el comprador.
Rechazos del banco o del proveedor
Cuando el proveedor rechaza la tarjeta, el comprador ve: "Tu pago fue rechazado. Revisa los datos o prueba otra tarjeta." Si el proveedor falla sin dar una respuesta, el comprador ve: "El pago falló. Inténtalo de nuevo."
Los códigos cambian de un proveedor a otro. Estos son los grupos más comunes en la columna Error:
| Ejemplos de código | Qué significa | Qué puedes hacer |
|---|---|---|
CARD_DECLINED, do_not_honor, insufficient_funds, card_velocity_exceeded | Rechazo del banco de la tarjeta, por saldo, límite o sin motivo informado. Un nuevo intento puede pasar. | Ten una cuenta de fallback en los flujos de pago: intenta cobrar cuando la primera rechaza. Sugiérele al comprador otra tarjeta o PIX (el pago instantáneo de Brasil). |
expired_card, suspected_fraud | Rechazo definitivo: tarjeta vencida o compra marcada como sospechosa por el banco. Intentar de nuevo con la misma tarjeta no lo resuelve. | El comprador tiene que usar otra tarjeta o hablar con su banco. |
issuer_unavailable, PROVIDER_UNAVAILABLE | El banco o el proveedor no respondió a tiempo. | Pídele al comprador que lo intente en unos minutos. Una cuenta de fallback en los flujos también ayuda. |
PAYMENT_FAILED | El proveedor rechazó y no explicó. El mensaje de al lado suele traer el detalle. | Lee el mensaje. Si habla de datos de la cuenta o de configuración, revisa la conexión con Probar en PagosProveedores. |
payment_expired | El PIX o el boleto (comprobante de pago bancario de Brasil) venció sin pago. | Nada en la tienda. El comprador puede volver al checkout y generar otro código. |
3D Secure
En cobros con autenticación del banco, la columna Respuesta del proveedor muestra también el resultado de 3DS. Cuando la autenticación falla, el banco rechaza el cobro aunque la tarjeta sea correcta.
Errores en el formulario de la tarjeta
Estos mensajes aparecen antes de que el cobro llegue al proveedor. El comprador corrige y lo intenta de nuevo. No hay pedido nuevo ni intento registrado.
| El comprador ve | Qué pasó | Qué puedes hacer |
|---|---|---|
| "Falta completar algún campo de la tarjeta. Revisa el número, la fecha de vencimiento y el CVV." | Un campo de la tarjeta quedó vacío o incompleto. | Nada. |
| "Los datos de la tarjeta no coinciden. Revisa el número, la fecha de vencimiento y el CVV." | El número, la fecha de vencimiento o el CVV no son válidos. | Nada. |
| "Esta tarjeta está vencida. Revisa la fecha o usa otra tarjeta." | La fecha de vencimiento ya pasó. | Nada. |
| "No aceptamos esta marca de tarjeta. Prueba con otra." | Las cuentas de pago de la tienda no aceptan esa marca. | Revisa las marcas de cada proveedor en funciones por proveedor. Para aceptar otra marca, conecta un proveedor que la acepte. |
| "Ingresa un documento válido" | El CPF (número de contribuyente de Brasil para personas) o el CNPJ (número de contribuyente de Brasil para empresas) es incorrecto. El checkout verifica los dígitos verificadores. | Nada. El comprador corrige el documento en la etapa de datos. |
| "No pudimos conectar con el servidor. Revisa tu conexión e inténtalo de nuevo: tu pedido sigue aquí." | Se cayó la conexión a internet del comprador durante el pago. | Nada. |
| "El formulario de pago aún no está listo." | El comprador hizo clic en pagar antes de que el campo de la tarjeta terminara de cargar. | Nada. Espera un momento y vuelve a hacer clic. |
Errores del pedido
Estos mensajes vienen de una regla de la tienda o del estado del checkout.
| El comprador ve | Qué pasó | Qué puedes hacer |
|---|---|---|
| "Esta tienda no puede cobrar en esta moneda. Elige otra, si hay, o habla con el vendedor." | Ninguna conexión activa de la tienda cobra en la moneda elegida. | Conecta un proveedor que cobre en esa moneda o quita de la oferta el precio en esa moneda. Mira funciones por proveedor. |
| "El pago en cuotas no está disponible en esta tienda por ahora. Elige pagar en una sola cuota e inténtalo de nuevo." | La cuenta de pago que recibió la venta rechazó las cuotas. | Abre PagosCuotas y haz clic de nuevo en Guardar cambios: al guardar la regla es cuando las cuentas pasan a aceptar cuotas. Mira cuotas. |
| "El total quedó por debajo del cobro mínimo. Quita el cupón e inténtalo de nuevo." | Con los descuentos, el total quedó por debajo de una unidad de la moneda, como R$ 1,00. | Revisa el descuento del cupón en CatálogoCupones. Mira cupones. |
| "Uno de los cupones ya no es válido. Quítalo e inténtalo de nuevo." | El cupón venció, se desactivó o llegó al límite de uso mientras el comprador estaba en el checkout. | Revisa el cupón en CatálogoCupones. |
| "Una de las ofertas adicionales ya no está disponible." | Un order bump marcado se pausó o se eliminó durante la compra. El checkout desmarca la casilla solo. | Nada, si fue a propósito. Si no, revisa los order bumps de la oferta. |
| "Este paquete ya no está disponible." | El paquete del enlace se eliminó. | Revisa los paquetes de la oferta y el enlace usado en la página de ventas. |
| "No entregamos en esta dirección." | Ninguna zona de envío atiende la dirección. | Revisa las zonas en CatálogoEnvío. |
| "Elige un método de envío." o "Indica la dirección de entrega." | Falta el método de envío o la dirección de un producto físico. | Nada. El comprador completa el formulario. |
| "No vendemos al país seleccionado." o "No entregamos en el país seleccionado." | El país del comprador o de la entrega está fuera de los países que acepta la tienda. | Revisa los países de venta y de entrega en dónde vendes y adónde entregas. |
| "Este checkout quedó abierto demasiado tiempo y expiró. Tus datos siguen completos: solo inicia un nuevo checkout para pagar." | El checkout quedó abierto más de 24 horas. El botón de la ventana cambia a "Iniciar un nuevo checkout". | Nada. |
| "Este checkout expiró. Recarga la página para continuar." | El mismo checkout ya se pagó o está esperando un PIX, por ejemplo en otra pestaña. | Nada. |
| "No pudimos iniciar el pago ahora. Tus datos están bien: inténtalo de nuevo en un momento o habla con la tienda." | La plataforma de pagos se negó a abrir el checkout por un motivo que no tiene que ver con los datos del comprador. | Revisa que las conexiones de la tienda estén activas y probadas en PagosProveedores. Si sigue, habla con el soporte de Vipter. |
| "No pudimos iniciar el pago. Revisa tus datos." | Algún dato de la etapa de contacto está en un formato que el checkout no acepta. | Nada. |
| "No hay métodos de pago disponibles para este vendedor ahora." | No hay un flujo de pago activo para tarjeta ni para PIX. | Crea o activa un flujo en PagosFlujos de pago. |
| "No se pudo cargar el pago" | El campo de pago no cargó en el navegador. | Pídele al comprador que recargue la página o pruebe otro navegador. |
Enlace de pago no disponible
Cuando el enlace no puede vender, el comprador ve la página "Este enlace de pago no está disponible", con el texto "La oferta puede haber sido desactivada o el enlace es incorrecto. Contacta al vendedor." La dirección de esa página trae el motivo después de ?reason=:
| Motivo | Qué pasó | Qué puedes hacer |
|---|---|---|
not_found | El enlace no existe, la tienda se eliminó o el dominio propio no es de esta tienda. | Revisa el enlace copiado de la oferta. |
link_disabled | El Enlace de pago de la oferta está apagado. | Enciende Enlace activo en la oferta. |
offer_archived | La oferta se archivó. | Desarchivar la oferta. |
no_prices | La oferta no tiene precio. | Registra un precio en la oferta. |
no_settleable_price | Ninguna conexión activa cobra en las monedas de los precios de la oferta. | Conecta un proveedor que cobre en esa moneda. |
pack_unavailable | El enlace apunta a un paquete que la oferta ya no tiene. | Usa el enlace actual del paquete. |
project_unavailable | La tienda no está vendiendo: activación no terminada, tienda Suspendido o ventas pausadas por Ventas pausadas: hay un cobro de excedente abierto. Actualiza la tarjeta para volver a vender. | Mira estado de la tienda. |
Rechazos después de la compra
- En el upsell de 1 clic, el comprador ve "La tarjeta no autorizó este cobro. Tu compra original sigue confirmada." cuando el banco rechaza, o "No pudimos procesar esta oferta ahora. Tu compra original sigue confirmada." cuando no se pudo hacer el cobro. La primera compra no cambia. Mira upsell de 1 clic.
- En una venta hecha desde el panel en la tarjeta guardada del cliente, el panel muestra Venta rechazada: código del proveedor
- En un cobro extra de suscripción, el panel muestra Cobro extra rechazado: código del proveedor
En los dos casos del panel, el motivo es el mismo código de la columna Error, y la tabla de la primera sección de esta página ayuda a leerlo.
Qué hacer después
- Arma una cuenta de fallback para los rechazos temporales en flujos de pago.
- Mira qué quiere decir cada estado del pedido en estados de pedido, suscripción y proyecto.
Estados de pedido, suscripción y proyecto
Qué significa cada estado que muestra el panel en pedidos, intentos de pago, suscripciones, checkouts abandonados y en la propia tienda.
Funciones por proveedor
Tabla de referencia con los medios de pago, cuotas, países, monedas, marcas de tarjeta, funciones, credenciales y webhook de cada proveedor que Vipter conecta.