Pruebas en sandbox - Cobrix Docs

Preparación

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

API de integraciones

Caso	Resultado esperado
Bearer inválido	`401 invalid_api_key`
Firma alterada	`401 invalid_signature`
Timestamp vencido	`401 timestamp_out_of_tolerance`
`POST` sin idempotencia	`400 missing_idempotency_key`
Replay idéntico	Misma respuesta, sin duplicados
Cliente y documento upsert	`created`, luego `unchanged` o `updated`
Link con documentos de clientes distintos	`422`
Pago verificado repetido	`already_processed` o replay original
Pago multimoneda sin tasa	`needs_certified_rate`

Documentos de cobro públicos

Caso	Resultado esperado
Crear USD 20,25	`201`, `amount: 20.25` y link de pago
Replay idéntico	Mismo `id` y `payment_id`
Misma clave, otro cuerpo	`409 idempotency_error`
Actualizar pendiente 20 → 25 → 18	Checkout reemplazado y ledger balanceado
Cambiar `provider`	`422 errors.provider`
Actualizar con pago aplicado	`409 errors.payment`
Cambiar monto pagado	`409 errors.amount`
Anular pendiente	`204` y estado `DELETE_FROM_PROVIDER`
Actualizar anulada	`409 errors.status`
Eliminación masiva	`202` con JSON `null`

Webhooks

Verifica la firma antes de parsear.
Envía el mismo evento dos veces y confirma deduplicación.
Fuerza un 500 temporal y comprueba el reintento.
Confirma que los webhooks generales aceptan cualquier 2xx.
Confirma que los webhooks de documentos públicos requieren 200 exacto.

Limpieza

Anula los documentos sintéticos pendientes. Identifica expresamente cualquier documento liquidado desde proveedor, porque no debe revertirse fuera del flujo financiero oficial.

Errores y rate limits