Conectar Pagar.me
Cobra en reales con tarjeta en cuotas y PIX a través de tu cuenta de Pagar.me, con suscripciones, order bump y upsell de 1 clic.
Pagar.me procesa tarjeta de crédito, tarjeta de débito y PIX (el pago instantáneo de Brasil) en reales, para cuentas abiertas en Brasil. Conectada a Vipter, atiende ventas únicas, cuotas con tarjeta, suscripciones, order bump y upsell de 1 clic.
Antes de empezar
- Una cuenta de Pagar.me activa. Para probar antes, sirve el entorno de prueba de Pagar.me.
- Acceso a la Dashboard de Pagar.me para ver las claves y crear webhooks.
- Rol Admin o Propietario en el proyecto de Vipter.
- Espacio en tu plan para una conexión activa más. La pantalla de proveedores muestra cuántas usas.
Paso 1: copiar la clave secreta en Pagar.me
- Entra a la Dashboard de Pagar.me y revisa en qué entorno estás. Las claves de prueba sirven para probar y las de producción para vender.
- Abre la página de claves de acceso de la Dashboard y copia la chave secreta (clave secreta) del entorno que elegiste. La clave secreta de prueba empieza con
sk_test_.
Guarda la clave con cuidado
La clave secreta da acceso a las ventas de tu cuenta de Pagar.me. Pégala solo en Vipter. Si se filtra, genera otra en Pagar.me y cámbiala en Vipter con el botón Cambiar claves.
Paso 2: crear la conexión en Vipter
- En el panel de Vipter, abre PagosProveedoresPagar.me.
- Haz clic en Nueva conexión. Si la tienda aún no tiene ninguna cuenta de Pagar.me, el formulario ya aparece abierto.
- Completa los campos numerados:
| # | Campo | Qué pegar |
|---|---|---|
| 1 | Nombre de la cuenta | Un nombre para reconocer la cuenta, como "Pagar.me Tienda". Aparece en los flujos de pago. |
| 2 | País de la cuenta | Brasil, ya seleccionado. Pagar.me solo atiende cuentas abiertas en Brasil. |
| 3 | Clave de API (Secret key) | La clave secreta que copiaste en el paso 1. |
| 4 | Conexión de prueba | Encendido, usa las claves y las tarjetas de prueba de Pagar.me (sk_test_). Apágalo para cobrar de verdad con la clave de producción. |
- Haz clic en Guardar y obtener la URL del webhook. Vipter verifica la clave con Pagar.me antes de guardar. Si está mal, no se guarda nada y el error aparece en el formulario.
El modo de prueba empieza encendido
El interruptor Conexión de prueba empieza encendido para que una primera conexión no le cobre a nadie por error. Para vender, crea la conexión con él apagado y la clave de producción.
Si la tienda todavía no tiene flujo para tarjeta de crédito, tarjeta de débito o PIX, Vipter crea esos flujos apuntando a la nueva cuenta. La tienda ya puede cobrar después del paso 4.
Paso 3: registrar el webhook en Pagar.me
Por el webhook, Pagar.me le avisa a Vipter lo que pasa después de la compra: PIX pagado, reembolsos, contracargos y cobros cancelados o vencidos. Pagar.me demuestra que el aviso es suyo con un usuario y una contraseña (autenticación HTTP Basic) que tú mismo eliges. Sin ese par, la plataforma de pagos rechaza los avisos de Pagar.me.
- Después de guardar, la tarjeta de la conexión muestra la URL del webhook. Cópiala.
- En la misma tarjeta, inventa un usuario y una contraseña y completa los dos campos:
| # | Campo | Qué pegar |
|---|---|---|
| 1 | Usuario del webhook (Basic Auth) | Cualquier usuario, como vipter-webhook. Vas a repetir el mismo valor en Pagar.me. Aparece como opcional, pero sin él los avisos se rechazan. |
| 2 | Contraseña del webhook (Basic Auth) | Una contraseña larga, solo para este webhook. No uses la contraseña de tu cuenta de Pagar.me. |
- Haz clic en Guardar secreto.
- En la Dashboard de Pagar.me, abre ConfiguraçõesWebhooks (Configuración › Webhooks) y haz clic en Criar webhook (Crear webhook).
- Pega la URL que copiaste en el punto 1.
- Selecciona los eventos de pedido y de cobro. Vipter usa estos:
- pedido:
order.paid,order.payment_failedyorder.canceled; - cobro:
charge.paid,charge.pending,charge.payment_failed,charge.refunded,charge.partial_canceled,charge.canceled,charge.chargedback,charge.expired,charge.underpaidycharge.overpaid.
- pedido:
- Activa la autenticación del webhook e ingresa el mismo usuario y la misma contraseña del punto 2.
- Confirma con la contraseña de tu cuenta de Pagar.me y guarda.
Un webhook por entorno
El webhook creado en el entorno de prueba de Pagar.me solo avisa de las ventas de prueba. Cuando crees la conexión de producción, registra otro webhook en el entorno de producción con la URL de esa nueva conexión.
Paso 4: probar la conexión
- En la tarjeta de la conexión, haz clic en Probar. Vipter consulta a Pagar.me con la clave guardada.
- Haz una compra de prueba en el checkout de una oferta. Con el modo de prueba encendido, usa la tarjeta
4000 0000 0000 0010con cualquier fecha de vencimiento futura. En el entorno de prueba de Pagar.me, esta tarjeta siempre se aprueba.
Funcionó si
Aparece el mensaje Conexión OK., la tarjeta muestra Secreto de verificación configurado. y la compra de prueba aparece en VentasTransacciones como pagada.
Problemas comunes
-
Tu plan permite N conector(es) activo(s). Mejora el plan para agregar más.
Tu plan llegó al límite de conexiones activas. Desactiva una conexión que ya no uses o cambia de plan en Plan Vipter.
-
Pagar.me rechazó la clave
La clave está incompleta, es de otra cuenta o es de prueba con el modo de prueba apagado (o al revés). Copia de nuevo la clave secreta, no la pública (
pk_), y revisa el interruptor Conexión de prueba. -
Sin el secreto de verificación la plataforma rechaza los eventos de este proveedor. Registra la URL de arriba en el proveedor, copia el secreto y guárdalo aquí.
El usuario y la contraseña del webhook no se guardaron en Vipter. Repite los puntos 2 y 3 del paso 3.
-
El PIX se pagó, pero el pedido sigue pendiente
El aviso de Pagar.me no llegó o fue rechazado. Revisa que el webhook exista en el mismo entorno que la conexión (prueba o producción), que la URL sea la de la tarjeta de esta conexión y que el usuario y la contraseña en Pagar.me sean iguales a los guardados en Vipter. Si cambias los valores, guárdalos de nuevo en los dos lados.
Qué hacer después
- Define cuántas cuotas ofrece la tienda y con qué interés en cuotas.
- Revisa los flujos de pago para decidir qué cuenta cobra cada pago y cuál queda de fallback.