VipterCentro de Ayuda
Checkout

Recibir con PIX

Activa PIX en el checkout, mira lo que recibe el comprador y entiende cuándo el pedido queda pagado y qué pasa cuando el código vence.

Admin o PropietarioTodos los planesVerificado el 28 sept 2026

Con PIX (el pago instantáneo de Brasil) activo, el comprador elige PIX en el paso de pago, recibe un código QR y un código para copiar y pegar, y paga desde la app de su banco. El checkout detecta el pago solo y lleva al comprador a la página de agradecimiento.

Antes de empezar

  • Una cuenta en un proveedor que recibe PIX, conectada a Vipter: Pagar.me, Mercado Pago o Asaas.
  • El webhook de ese proveedor registrado. Es por ahí que el proveedor avisa que el PIX se pagó. Consulta Webhooks de los proveedores.
  • Rol Admin o Propietario en el proyecto de Vipter.

Dónde aparece PIX

PIX aparece en el checkout cuando se cumplen tres condiciones:

  • La compra es de pago único. Las suscripciones cobran solo con tarjeta.
  • La tienda tiene un flujo de pago de PIX activo, que apunta a una conexión activa que recibe PIX.
  • El precio está en reales. PIX es un medio de pago brasileño.

Al crear una conexión con un proveedor que recibe PIX, Vipter crea un flujo de PIX que apunta a ella, si la tienda todavía no tiene un flujo de PIX activo. Para revisarlo, abre PagosFlujos de pago y busca el flujo de PIX. Para elegir qué cuenta recibe el PIX, consulta Flujos de pago.

Con tarjeta y PIX activos, el comprador ve las dos opciones una al lado de la otra en el paso de pago.

Lo que ve el comprador

  1. En el paso de pago, el comprador elige PIX. El checkout muestra para qué documento se emitirá el PIX: el CPF (número de contribuyente de Brasil para personas) o el CNPJ (número de contribuyente de Brasil para empresas) indicado en el paso de datos. Para usar otro documento, corrige el campo de arriba.
  2. Hace clic en el botón para generar el código.
  3. El checkout muestra el código QR, el código para copiar y pegar con un botón de copiar y el tiempo que falta para que el código venza.
  4. El comprador paga desde la app de su banco. La página revisa el pago cada pocos segundos y, cuando se confirma, sigue sola hacia las ofertas poscompra, si las hay, y hacia la página de agradecimiento.
Checkout con el código QR de PIX, el código para copiar y pegar y el tiempo restante
Ilustración provisional: la pantalla real puede tener pequeñas diferencias. La captura definitiva llegará pronto.

El plazo de validez del código lo define el proveedor. En Pagar.me y en Mercado Pago, el código vale 24 horas.

Si la tienda envía correos a los compradores, el comprador también recibe el correo PIX pendiente de pago, con el código para copiar y pegar y su validez. Así puede pagar incluso después de cerrar la página. Los correos están en GeneralConfiguraciónCorreos.

Cuándo queda pagado el pedido

El pedido aparece en VentasTransacciones en cuanto se genera el código, con el método PIX y el estado Pendiente. Pasa a Pagado cuando el proveedor confirma el pago.

La confirmación llega por el webhook del proveedor. Mientras el comprador tiene la página abierta, el checkout también consulta el estado directamente, así que no se queda esperando si el aviso se retrasa.

Con el pedido pagado, pasa lo mismo que en una venta con tarjeta: página de agradecimiento, correo de confirmación, enlaces de descarga, acceso al área de miembros, eventos de compra para los píxeles y las integraciones.

Para los píxeles de anuncios, Vipter también registra el evento PIX generado cuando el código aparece en pantalla.

Cuando el código vence

  • El checkout cambia el código QR por un aviso de que el código venció y pide al comprador que recargue la página. Al recargarla, empieza la compra de nuevo y genera un código nuevo.
  • El pedido del código vencido no se paga.
  • Si el correo PIX vencido está activado, el comprador recibe un correo con un botón para volver al checkout. Este correo viene desactivado: actívalo en GeneralConfiguraciónCorreos.

PIX en las ofertas poscompra

Quien pagó con PIX también ve los pasos de One-click Upsell de la oferta, después de que se confirma el PIX. Aceptar una oferta genera un PIX nuevo, solo para ella. El pedido original sigue pagado aunque el comprador no pague el segundo PIX.

Problemas comunes

  • La opción PIX no aparece en el checkout

    La oferta es una suscripción, el precio no está en reales o no hay un flujo de PIX activo con una conexión activa. Revísalo en PagosFlujos de pago.

  • El comprador pagó, pero el pedido sigue pendiente

    El webhook del proveedor no está registrado o tiene el secreto equivocado, y por eso la confirmación no llega. Vuelve a registrar el webhook siguiendo la página de tu proveedor. En Asaas, el token de autenticación del webhook es obligatorio.

  • El checkout rechaza el CPF o el CNPJ

    Los dígitos verificadores no coinciden. El comprador tiene que corregir el documento en el paso de datos.

Qué hacer después

En esta página