Errores y nombres de eventos de la API
Procese el estado HTTP antes de interpretar la decisión. La URL account-change usa guion, mientras el evento JSON es account_change. Un 401, 409, 422, 429 o 503 indica manejo de solicitud, autorización o servicio; no es una decisión allow/review/decline.
Autenticación y rutas
401 indica clave ausente/incorrecta o cuenta de piloto no autenticada. 409 en piloto indica que el evento no tiene ruta aprobada. Los IDs desconocidos o no aprobados seleccionados por el cliente devuelven 422. Solicitar una ruta aprobada no evita autenticación.
Validación y eventos
Use onboarding/onboarding, payout/payout y account-change/account_change como pares URL/cuerpo. Discrepancias y esquemas inválidos devuelven 422. Campos opcionales no significan que un proveedor funcione sin sus identificadores requeridos. Las rutas desconocidas deben fallar validación.
Límites e indisponibilidad
429 indica límite del piloto. 503 puede significar clave de producción ausente, piloto mal configurado o proveedor indisponible. Use el detalle para diagnóstico interno y siga el procedimiento limitado de reintento o revisión. Las trazas de producción no se consultan por defecto.
Fuentes y alcance
Basado en el contrato y código alfa. Las rutas reales requieren confirmación separada.