Pagos con Recurrente
La configuración de pagos en línea requiere Mont Blanc o Everest y el rol Admin. Olympus puede vender por WhatsApp, contra entrega o transferencia, pero no activar el checkout automatizado con tarjeta.
Antes de comenzar
Sección titulada «Antes de comenzar»- Ten una cuenta activa de Recurrente.
- Confirma con el equipo de Zenit que la URL pública del storefront esté activa.
- Confirma que Tarjeta esté habilitada en Logística.
- Obtén la Secret Key del ambiente de prueba o producción desde Configuración → Llaves API en Recurrente.
Configuración
Sección titulada «Configuración»- Abre Configuración y, en la tarjeta Pagos y suscripción, selecciona Configurar.
- Pega la Secret Key y guarda. Zenit Scent valida la llave, guarda el ambiente y registra el webhook automáticamente.
- Confirma que el panel muestre Webhook registrado automáticamente y el ambiente esperado.
- Si el registro automático falla, el panel muestra una URL de respaldo para registrar manualmente en el mismo ambiente de Recurrente.
- Prueba el flujo con objetos de prueba del sandbox y confirma que la orden aparezca en el panel.
Los endpoints automáticos usan firmas Svix verificadas por Zenit Scent. Una llave de prueba en el Worker de producción muestra la advertencia Estás usando una llave de prueba: los cobros no son reales.
Pausar y reanudar pagos en línea
Sección titulada «Pausar y reanudar pagos en línea»Con Recurrente conectado, la pantalla de pagos (Configuración → Pagos y suscripción) incluye el botón Pausar pagos en línea. Mientras estén en pausa, el panel muestra la insignia En pausa y una alerta, el checkout no cobra con tarjeta y tus clientes piden por WhatsApp; la conexión y el webhook siguen activos y los pagos ya iniciados se completan con normalidad. Pulsa Reanudar pagos en línea para volver a cobrar. No confundas la pausa con Desconectar, que elimina el webhook registrado en Recurrente.
Si tu storefront es una integración propia, consulta cómo reaccionar a la pausa en Uso de la API pública.
Estados importantes
Sección titulada «Estados importantes»- Pagada: pago confirmado y stock descontado.
- Transferencia en proceso: el pago bancario aún está pendiente.
- Pagada sin stock: se recibió el pago, pero no fue posible completar el descuento de inventario; atiéndela inmediatamente.
- Fallida: el pago fue rechazado o no pudo verificarse.
- Reembolsada: el dinero fue devuelto y el stock se restauró.
Reembolsos
Sección titulada «Reembolsos»Desde el detalle de una orden pagada, un Admin puede ejecutar un reembolso automático total. La acción devuelve el dinero al método original y restaura el stock. No puede deshacerse.
En Mont Blanc, realiza primero el reembolso desde el panel de Recurrente. Después, abre la orden en Zenit Scent y pulsa Marcar como reembolsada. Esto actualiza el estado y restaura el stock descontado, pero no mueve dinero; confirma la acción solo después de completar el reembolso en Recurrente. No inicies un reembolso automático desde Zenit Scent.
