Webhook del proveedor
Entiende por qué cada conexión necesita un webhook en el proveedor y qué registrar en cada uno.
La compra no termina cuando el comprador hace clic en pagar. Un PIX (el pago instantáneo de Brasil) se paga minutos después, una tarjeta puede pasar por una revisión, y los reembolsos y contracargos llegan días o semanas más tarde. El proveedor le avisa a Vipter de cada uno de esos cambios por un webhook: una dirección de tu conexión a la que envía los avisos.
Cada conexión tiene su propio webhook. Si tienes dos cuentas en el mismo proveedor, o una cuenta de prueba y otra de producción, registra un webhook para cada conexión, en el entorno correcto del proveedor.
Qué llega por el webhook
- PIX pagado: el pedido pasa de pendiente a pagado cuando el proveedor confirma el pago.
- Tarjeta aprobada después: pagos que quedaron en revisión o pendientes en el proveedor.
- Reembolsos: incluso los hechos directamente en el panel del proveedor.
- Contracargos y disputas.
- Cobros cancelados, vencidos o rechazados.
Sin el webhook, esos avisos no llegan a Vipter. El pedido puede quedar pendiente aunque ya esté pagado, y los reembolsos o contracargos no aparecen en la tienda ni en las integraciones que dependen de ellos, como el área de miembros.
Dónde está la URL
- Abre PagosProveedores y haz clic en la conexión.
- La tarjeta de la conexión tiene la sección Webhook del proveedor, con la URL del webhook y un botón para copiar. Justo encima de la URL, la tarjeta dice dónde pegar la dirección en ese proveedor.
Justo después de crear una conexión, esa sección aparece resaltada con el aviso Falta un paso: registra este webhook en el proveedor.
El secreto de verificación
Cualquiera puede enviar un mensaje a una URL. Para aceptar solo los avisos que de verdad vienen del proveedor, la plataforma de pagos verifica cada aviso con un secreto de verificación. Sin el secreto, rechaza todos los avisos de esa conexión.
La tarjeta muestra en qué punto está la conexión:
| La tarjeta muestra | Qué significa |
|---|---|
| Secreto de verificación configurado. | El secreto está guardado. Los avisos del proveedor se aceptan. |
| 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í. | Falta guardar el secreto. Hasta entonces, todos los avisos se rechazan. |
| Este proveedor firma los eventos con la clave que ya ingresaste: no hay un secreto extra que registrar. | El proveedor usa la clave que ya ingresaste. Basta con registrar la URL. |
Qué pide cada proveedor
| Proveedor | Secreto en Vipter | De dónde viene |
|---|---|---|
| Stripe | Secreto del webhook (Signing secret) | Stripe lo genera al crear el destino del webhook. Empieza con whsec_. |
| Pagar.me | Usuario del webhook (Basic Auth) y Contraseña del webhook (Basic Auth) | Tú los eliges y registras los mismos valores en la autenticación del webhook de Pagar.me. |
| Mercado Pago | Secreto del webhook (firma secreta) | Mercado Pago lo genera al configurar las notificaciones de la aplicación. |
| Asaas | Token del webhook | Lo defines al crear el webhook en Asaas, o usas el token que genera. De 32 a 255 caracteres, sin espacios. |
| Paystack | Ninguno | Paystack firma con la Secret Key de la conexión. |
Los pasos completos están en la página de cada proveedor: Stripe, Pagar.me, Mercado Pago, Asaas y Paystack.
Guardar o cambiar el secreto
- En la tarjeta de la conexión, completa el campo del secreto debajo de la URL.
- Haz clic en Guardar secreto. Aparece el mensaje Secreto del webhook guardado.
Para cambiar el secreto, haz lo mismo con el valor nuevo. El secreto guardado en Vipter y el del proveedor siempre tienen que ser iguales: si lo renuevas en el proveedor, guárdalo de nuevo en Vipter.
Problemas comunes
-
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í.
Puede que la URL ya esté registrada en el proveedor, pero el secreto no se guardó en Vipter. Copia el secreto del proveedor (o, en Pagar.me y Asaas, el valor que elegiste) y guárdalo en la tarjeta.
-
La tarjeta muestra el secreto configurado, pero los pedidos no cambian de estado
Los avisos llegan con un secreto distinto, o ni siquiera llegan. Revisa que la URL registrada en el proveedor sea la de esta conexión, que el webhook se haya creado en el mismo entorno (prueba o producción) y que el secreto sea el mismo en los dos lados.
-
No se pudo armar la URL del webhook de esta conexión. Recarga la página o contacta al soporte.
Vipter no pudo armar la dirección de esta conexión. Recarga la página. Si sigue pasando, habla con soporte.
Qué hacer después
- Revisa los flujos de pago para decidir qué cuenta cobra cada pago.
- Consulta cómo funcionan los pagos para entender el camino completo de un cobro.