Skip to main content

​
Preparación

  1. Usa https://sandbox-api.cobrix.co/api.
  2. Crea el partner y la llave dentro de la empresa QA.
  3. Usa referencias únicas por ejecución.
  4. Configura un webhook exclusivo de pruebas.
  5. No uses emails o teléfonos de clientes reales.

​
API de integraciones

​
Documentos de cobro públicos

​
Webhooks

El receptor de pruebas debe registrar identificadores, firma válida, hora y HTTP, sin ejecutar pagos ni contactar personas. Usa datos sintéticos y desactiva cualquier salida hacia correo, WhatsApp, bancos o sistemas de clientes.
El botón de prueba emite webhook.test por un recorrido de conectividad propio. Un ping exitoso no certifica el nuevo dispatcher, su concurrencia ni la recuperación de recordatorios. Para esos casos usa un productor de negocio afectado dentro de una empresa QA aislada y un receptor exclusivo de pruebas.
No fuerces saturación, caídas de receptores, reintentos globales ni reinicios en producción para probar estos casos. Un ensayo de 61 eventos no certifica el tiempo de un lote de 10.000 ni la entrega a WhatsApp.

​
Registro de resultados

Anota ambiente, versión desplegada, fecha, número de eventos preparados, pendientes, aceptados por HTTP y fallidos. Conserva los identificadores de seguimiento en una evidencia privada, junto con el HTTP observado y los intentos de cada evento. Informa por separado lo observado en el receptor y lo registrado en Cobrix. El log del evento refleja el último resultado: al entregar correctamente, lastError se limpia y lastResponseStatus cambia. No lo uses como historial completo de todos los intentos; conserva las observaciones del ensayo por separado. Si sólo se ejecutaron pruebas locales o un ping, indícalo expresamente; no lo presentes como una validación de recuperación o capacidad en producción.

​
Limpieza

Desactiva el endpoint exclusivo de prueba cuando termines y revisa que no queden eventos de ese ensayo pendientes. Conserva la auditoría. Anula sólo los documentos sintéticos pendientes creados por el ensayo; comprueba antes los efectos de sus webhooks de anulación. Identifica expresamente cualquier documento liquidado desde proveedor, porque no debe revertirse fuera del flujo financiero oficial.