Lista para salir a producción
Lista para salir a producción
El sandbox demuestra que tu código funciona. No puede demostrar que tu afiliación bancaria funciona: las credenciales reales, el estado de tu contrato y los permisos de domiciliación solo existen en producción.
Esta lista cubre esa brecha. Son cinco pasos, y los cuatro primeros se marcan solos cuando haces la acción correspondiente.
Esto es una guía, no un requisito. Nada de esta lista bloquea tus llaves de producción, tus cobros ni tu cuenta. Si tu organización ya está operando, puedes ignorarla por completo: verás los pasos que nunca generaron una señal como "sin datos", y eso no significa que algo esté mal.
1. Verifica las credenciales de tu banco
En Configuración → Organización, donde cargaste las credenciales del banco, aparece el botón Probar conexión.
Ese botón hace la llamada autenticada más barata que permite tu banco —en BNC, el saludo
LogOn que intercambia tu MasterKey por una clave de sesión— y no mueve dinero. Te responde
una de cuatro cosas:
| Resultado | Qué significa | Qué hacer |
|---|---|---|
| Conexión correcta | El banco aceptó tus credenciales | Nada. El paso queda marcado con la fecha |
| Credenciales rechazadas | El banco respondió y las rechazó | Verifícalas con tu ejecutivo y cárgalas de nuevo |
| El banco no respondió | No es problema tuyo | Intenta más tarde; tu verificación anterior se conserva |
| Nada que probar | Esta configuración no guarda credenciales propias | Nada. Ver abajo |
La distinción entre la segunda y la tercera es deliberada: durante una caída del banco no tiene sentido que te mandemos a reescribir credenciales que siempre estuvieron bien.
La cuarta aparece si cobras por BNC con las llaves de Venflow (el modo integrador): tu organización no guarda credenciales, así que no hay nada que verificar. BNC ya confirmó tu afiliación al activar ese modo, y ese es el paso que de verdad cuenta.
Puedes probar varias veces seguidas, pero no sin límite: después de unos cuantos intentos en pocos minutos hay que esperar, para que un botón trabado no termine golpeando al banco.
2. Configura un webhook y envía un evento de prueba
Crea el webhook en Desarrolladores → Webhooks, y usa el botón de envío de prueba.
El paso se marca cuando una entrega de prueba resulta exitosa: es decir, cuando tu servidor recibió el evento firmado y respondió correctamente. Una entrega fallida no cuenta, porque es justo lo que este paso tiene que certificar. Una entrega real tampoco cuenta: eso es tráfico de producción, no una integración probada.
Revisa también que estés validando la firma X-Webhook-Signature. La guía de
webhooks explica cómo.
3. Completa un cobro en el sandbox
Con tu clave de prueba (pvtk_), abre un checkout y llévalo hasta el final:
Primeros pasos lo recorre en cinco llamadas. Los
valores de prueba hacen que el banco simulado apruebe o
rechace a voluntad, para que también ensayes lo que pasa cuando algo sale mal.
El paso se marca con un checkout completado en tu sandbox, no en producción. Un cobro real completado no demuestra que probaste la integración: demuestra que un cliente ya pagó, que es exactamente la situación que esta lista busca que ocurra después.
4. Carga tu catálogo
Ten al menos un producto o un plan creado en tu organización real. Si trabajaste en el sandbox, puedes copiar tu catálogo con el botón Copiar a sandbox en sentido contrario: lo que construyas en producción se copia hacia el sandbox, nunca al revés.
5. Haz un cobro piloto real con tu propia cuenta
Este es el único paso que nadie puede marcar por ti, y el más importante.
Qué hacer: crea un plan de monto mínimo (la práctica del equipo es $0.01), domicilia tu propia cuenta bancaria y deja que el cobro ocurra de verdad, con tus credenciales de producción y tu banco real.
Qué comprobar:
- El cobro se ejecuta y el dinero se mueve.
- La transacción queda registrada con el estado correcto en el panel.
- Tu servidor recibe el webhook de pago exitoso y lo procesa.
- La factura y la suscripción quedan como esperas.
Por qué con tu propia cuenta: porque es la única forma de ver el dinero entrar sin arriesgar la experiencia de un cliente. Venflow nunca ejecuta un cobro real en tu nombre para probar, así que este paso lo haces tú y lo marcas tú en la lista.
Hazlo con un monto mínimo y con una cuenta tuya. Si algo sale mal, el costo de descubrirlo es de centavos y el afectado eres tú, no un cliente.
Cuando lo completes, marca Ya lo hice en el widget del panel. Puedes desmarcarlo después si te equivocaste: la lista registra lo que tú sabes que hiciste, no un permiso que haya que ganarse.
Después de la lista
No pasa nada automáticamente. No se activa ni se desactiva nada, no cambia el estado de tu organización, y tus llaves de producción funcionan igual antes y después. La lista existe para que el primer cobro real no sea también la primera vez que descubres un problema.