Errores
Forma común de las respuestas de error.
Los errores JSON traen statusCode, error (código estable), message, timestamp y path (la ruta de la petición). Un 409 con idempotency_request_in_progress significa que la misma Idempotency-Key se está procesando: reintenta igual. Un 422 idempotency_key_reuse significa que reutilizaste la llave con otro cuerpo.
Los cuerpos y respuestas usan camelCase (orderReference, expiresInSeconds, beneficiaryId, settledAt, eventTypes). El ValidationPipe rechaza campos no declarados (400) y no convierte nombres distintos al contrato.
Un campo no declarado o con tipo inválido responde con el 400 estándar de validación: error es "Bad Request" y message es un arreglo con un texto por problema (p. ej. "property order_reference should not exist"). En los objetos anidados de la verificación, una llave que no es camelCase responde 400 validation_failed con fields[].code = unknown_field.
En las rutas que reciben un UUID, un id con otro formato responde 404 not_found, igual que un recurso que no existe o que es de otro comercio.
Las rutas de esta referencia están en las secciones de cobros, transferencias, saldo, verificación y eventos.