Migrar a los nombres en inglés

Desde la versión 2026-11-03 todos los identificadores de la API están en inglés: rutas, campos, valores y códigos de error. Los textos para personas (message) siguen en español.

Si tu cuenta existía antes de esa fecha, sigue en 2026-10-22 (los nombres de siempre) durante 90 días: nada se rompe hoy. Producción arranca sólo en inglés, así que conviene pasarse antes de salir.

Lo que no cambia

Si dispersas con cotización, beneficiario y pago, casi todo sigue igual:

• POST /v1/quotes, POST /v1/payouts, /v1/beneficiaries, /v1/payments, /v1/events, GET /v1/limits/usage y GET /v1/treasury/position, con sus campos.
• pago_movil y transferencia en method: son los nombres de los métodos de pago venezolanos y no se traducen.
• Los webhooks payment.settled, payment.failed y payment.reversed, su payload y su firma.
• Idempotency-Key, la paginación y los demás error.code que ya estaban en inglés (limit_exceeded, insufficient_tenant_funds, quote_expired…).

Lo que cambia

Antes (2026-10-22)	Ahora (2026-11-03)
reference: "PRUEBA:SUBMITTED" (también UNKNOWN, SETTLED, TIMEOUT_AFTER_SUBMIT)	reference: "TEST:SUBMITTED"
GET /v1/tenant/me → entorno: pruebas | real	environment: sandbox | production
GET /v1/tenant/capacidades	GET /v1/tenant/capabilities
fondeo.modelo: cierre_diario | prefondeado | cuenta_propia	funding.model: daily_settlement | prefunded | own_account
fondeo.limiteCredito, fondeo.dondeVerSaldo	funding.creditLimit, funding.balanceEndpoint
dispersion.metodos, limites[], tasaVenta[]	payouts.methods, limits[], sellRates[]
POST /v1/treasury/tasa-venta con { "tasa" }	POST /v1/treasury/sell-rate con { "rate" }
tasa, fijadaEn, deHoy	rate, setAt, isToday
GET /v1/treasury/volumen?desde=&hasta=	GET /v1/treasury/volume?from=&to=
pagos, tramos, detalle, comisionRedBs	paymentCount, tiers, lines, networkFeeBs
GET /v1/treasury/fee-volumen (vigenteDesde)	GET /v1/treasury/volume-fee (effectiveFrom)
GET /v1/treasury/inventario (saldoBs, costoUsd, tasaPromedio)	GET /v1/treasury/inventory (balanceBs, costUsd, averageRate)
GET /v1/payments/metricas	GET /v1/payments/metrics
POST /v1/pruebas/sembrar	POST /v1/test-helpers/seed
POST /v1/pruebas/fondeos con { "montoUsd", "montoBs", "referencia" }	POST /v1/test-helpers/fundings con { "amountUsd", "amountBs", "reference" }
POST /v1/pruebas/pagos/{id}/resolver con { "resultado" }	POST /v1/test-helpers/payments/{id}/resolve con { "outcome" }
POST /v1/tenant/webhook/test → entregado, pista	delivered, hint
pruebas_solo_cuenta_de_pruebas	test_account_required
tenant_sin_tasa_venta · fondeo_referencia_reusada	sell_rate_missing · funding_reference_reused

La lista completa de campos de cada ruta está en la referencia de la API.

Cómo pasarte

1. Prueba sin cambiar nada

   Manda el header BC-Version: 2026-11-03 en tus llamadas de pruebas. Esa petición sale en inglés; las demás, como siempre.

   curl -s $BASE/v1/tenant/capabilities -H "x-api-key: $KEY" -H "BC-Version: 2026-11-03"

2. Cambia tu código

   Las rutas y los campos de la tabla. Mientras dure la ventana aceptamos los dos idiomas en lo que nos mandas, así que puedes cambiarlo por partes.

3. Fija la versión de tu cuenta

   curl -s -X PUT $BASE/v1/tenant/api-version -H "x-api-key: $KEY" \
     -H 'content-type: application/json' -d '{"version":"2026-11-03"}'

   Desde ese momento todo te llega en inglés, webhooks incluidos. Si algo se rompe, vuelve con {"version":"2026-10-22"} mientras dure la ventana.

Cómo sabes si te falta algo

Cada respuesta trae BC-Version con la versión con la que salió. Si usaste un nombre viejo (una ruta, un campo, PRUEBA: o la versión 2026-10-22), la respuesta trae además Deprecation y Sunset (la fecha en que deja de existir). Cuando ya no los veas, terminaste.

Producción, sólo en inglés

En producción no existe 2026-10-22: las rutas en español dan 404, los campos en español 400 validation_failed y BC-Version: 2026-10-22 da 400 api_version_unsupported.