Antes de cobrar dinero real

Usa esta lista para habilitar un negocio o pasar del modo de prueba al modo en vivo. Una prueba local o una pantalla que se abre sin errores no confirma la habilitación de un adquirente ni la autorización fiscal para facturar en vivo.

Configuración y credenciales

• Activaste solo lo que usarás: Cobra, Facturación o ambos.
• Configuraste por separado cada modo que usarás. No usas las claves de prueba en vivo.
• Guardas las claves de API, los secretos de firma del webhook y los certificados solo en el servidor.
• Para cobrar con Checkout, tu afiliación está conectada en vivo en Portal Timbro: Azul aceptó tus credenciales en vivo, o el equipo de Timbro conectó tu afiliación de CardNet o Portal.
• Para emitir e-CF en vivo, completaste la configuración fiscal y confirmaste la habilitación que corresponde a ese emisor.

Pagos

• Completaste un pago de prueba y consultaste el mismo Payment desde el servidor. Solo marcas el pedido pagado cuando su estado es succeeded.
• Compruebas referencia, moneda y monto antes de aplicar el pago al pedido.
• Si pierdes la respuesta, reenvías el mismo paymentReference con los mismos datos y consultas el mismo pago.
• Tu equipo sabe qué hacer cuando el estado es verifying: esperar y recuperar el mismo pago, sin iniciar otro pago.

Facturas y notificaciones

• Si emitirás e-CF, completaste una emisión de prueba y recuperaste la misma factura por invoiceId o invoiceReference.
• Tu sistema consulta la factura por separado del pago. Payment.status: "succeeded" no confirma aceptación fiscal ni que XML o PDF estén listos.
• Esperas a que el estado de cada archivo sea ready antes de descargarlo.
• Tu receptor verifica la firma del webhook, deduplica por event.id y recupera el pago o la factura que indica event.data.id.
• Tu equipo sabe escalar una factura que requiere intervención (operatorRequired).
• Si tu sistema envía las facturas desde una cola, busca la invoiceReference antes de emitir de nuevo, para no emitir la misma venta dos veces.
• Un solo sistema le envía la factura al comprador: Timbro o tu sistema.
• Antes de ofrecer un tipo de e-CF en vivo, compruebas en GET /v1/business que esté ready.

Soporte

• Conservas IDs, modo, Request-Id y códigos de error necesarios para investigar una falla.
• No registras claves, tokens, datos de tarjeta, XML/PDF completos ni links privados.
• Una persona revisa los pagos cuyo resultado sigue sin confirmarse y las facturas que requieren intervención.

Revisa las capacidades habilitadas y cómo manejar errores antes de pasar al modo en vivo.