> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Notas de Versión y Changelog de la API de SpherePay
> Últimas actualizaciones de la API de SpherePay: nuevas funciones, cambios disruptivos, deprecaciones, cumplimiento y nuevos rieles y activos.
Conoce todas las actualizaciones más recientes del Producto API de SpherePay. Aquí encontrarás información sobre nuevas funciones, cambios de API, deprecaciones, actualizaciones de cumplimiento y nuevos rieles/activos. Si tienes alguna pregunta, contacta a [support@spherepay.co](mailto:support@spherepay.co).
## Pagos internacionales por SWIFT
SpherePay ahora admite **SWIFT** para pagos off-ramp en USD a cuentas bancarias internacionales. Los fondos se convierten de stablecoin a USD y se envían como una **transferencia transfronteriza por la red SWIFT**, enrutada al banco del beneficiario a través de hasta **tres bancos intermediarios (corresponsales)** cuando es necesario.
**Registrar una cuenta bancaria beneficiaria SWIFT:**
* Crea una cuenta bancaria en USD con `currency: "usd"` y `networks: ["swift"]`
* Proporciona `accountNumber` (IBAN o BBAN) y el `bic` del banco del beneficiario (8 u 11 caracteres)
* Opcionalmente incluye `intermediaryBics` — una lista ordenada de hasta 3 BIC de bancos corresponsales (cada uno de 8 u 11 caracteres, sin duplicados)
El acceso a SWIFT requiere el **perfil de verificación C**. No se puede crear una cuenta bancaria SWIFT en USD hasta que el perfil C esté aprobado — contacta a tu representante de SpherePay para habilitarlo.
El soporte de SWIFT incluye pagos tanto de primera parte como de terceros. Lee más sobre los requisitos para los pagos de terceros [aquí](/es/implementation-guides/third-party-flows).
## Gestiona offloader wallets desde el dashboard
Los integradores ahora pueden generar y monitorear offloader wallets directamente desde el dashboard.
* **Genera offloader wallets** — crea nuevas direcciones de offloader wallet sin una llamada a la API.
* **Historial de transacciones de la wallet** — consulta el historial completo de transacciones de cada offloader wallet, incluidas las transferencias asociadas.
## Incorpora a tus clientes y consulta sus cuentas externas
Los integradores ahora pueden crear e incorporar a sus clientes finales directamente desde el dashboard, como parte del despliegue continuo del Integrators Dashboard.
* **Crea e incorpora un cliente** — agrega un cliente final (empresa o persona) y ejecuta la verificación KYB o KYC, con un enlace de Términos de Servicio por cliente y el estado de verificación en tiempo real.
* **Cuentas externas del cliente** — consulta las cuentas externas de un cliente directamente desde su pestaña de Cliente.
## Agrega cuentas y crea transferencias en nombre de tus clientes
Los integradores ahora pueden gestionar la actividad en nombre de sus clientes directamente desde el dashboard, como parte de la primera fase del lanzamiento del nuevo Integrators Dashboard.
* **Agrega cuentas de clientes** — agrega cuentas externas en nombre de tus clientes sin salir del dashboard.
* **Crea transferencias en nombre de tus clientes** — inicia transferencias desde esas cuentas en nombre de tus clientes.
* **Detalles de transferencia mejorados** — una vista renovada de confirmación y detalles facilita la revisión de cada transferencia.
## Navegación del Dashboard Rediseñada y Flujo de Transferencias
El dashboard de SpherePay ha sido renovado con una navegación más clara y un flujo de Transferencias reconstruido.
**Actualizaciones de navegación:**
* La Incorporación se ha movido fuera de la sección de Transferencias a su propio ítem de barra lateral "Comenzar", dando a los clientes un camino más claro a través de la plataforma desde el primer día.
* "Cuentas Bancarias" ha sido renombrado a "Cuentas Externas" para reflejar mejor cómo funciona el producto.
**Rediseño del flujo de Transferencias:** El flujo de Transferencias es ahora un recorrido por pasos con una página de entrada dedicada. Puedes elegir entre mover tus propios fondos, enviar a destinatarios o configurar cuentas Autoramp.
**Offloader Wallets:** Los Offloader Wallets ahora tienen una página dedicada bajo Cuentas Autoramp, con descripciones claras del producto y guías de uso para que los clientes tengan contexto completo antes de comenzar.
## Transferencias BRL/PIX Ahora Soportadas
SpherePay ahora soporta transferencias en BRL (Real Brasileño) a través de la red de pago instantáneo PIX.
**Rutas soportadas:**
* Off-ramp: USDC/USDT en Polygon, Ethereum, Base o Tron → PIX BRL
* On-ramp: PIX BRL → USDC/USDT en Polygon, Ethereum, Base o Tron
* Límites de transferencia: R$1.00–R$7,500.00 por transferencia
**Restricciones específicas de BRL:**
* Solo `integratorBpsFeeRate` está soportado para comisiones (`integratorFixedFee` no está permitido).
* Solana no está soportado para transferencias BRL.
* Las cuentas bancarias PIX requieren `currency: "brl"` y `networks: ["pix"]`.
Las transferencias BRL requieren un perfil de verificación separado (`kyc_profile_b` / `kyb_profile_b`). Contacta a tu representante de SpherePay para obtener acceso.
Para más detalles, consulta [API de Transferencias — Restricciones BRL/PIX](/es/concepts/transfers/overview#restricciones-de-transferencias-brlpix) y [Rieles y Divisas Soportadas](/es/concepts/transfers/supported-rails).
## Pagos Wire con Nombre
Los pagos por wire en USD ahora muestran el nombre de tu empresa como remitente en lugar de "Sphere." Esto se activa automáticamente cuando un cliente es aprobado — no se requiere configuración manual.
Los clientes aprobados existentes que han realizado transacciones en los últimos 3 meses han sido actualizados retroactivamente y verán este cambio reflejado de inmediato.
## Incorporación API-First por Defecto
SpherePay ahora establece por defecto un modelo de incorporación simplificado para aplicaciones integradas por API. Las verificaciones de vivacidad KYC y UBO, la verificación OTP de teléfono y correo, y la firma del MSA ya no son requeridas durante la incorporación cuando estos pasos son manejados por el integrador previamente.
Estas capacidades siguen siendo completamente soportadas y pueden habilitarse como requisitos opt-in por aplicación. Las aplicaciones existentes conservan su comportamiento actual — solo las nuevas aplicaciones reciben los valores por defecto simplificados.
Para más información, consulta la guía de [Clientes e Incorporación](/es/concepts/onboarding/overview).
## API de Offloader Wallets + Soporte para EURC
### API de Offloader Wallets
Los Offloader Wallets son billeteras de conversión automatizada de cripto a fiat que permiten a tus clientes recibir stablecoins y que se liquiden automáticamente en una cuenta bancaria vinculada.
**Stablecoins y redes soportadas:**
* USDC en Arbitrum, Avalanche, Base, Ethereum, Polygon y Solana
* USDT en Ethereum y Tron
* EURC en Base, Ethereum y Solana
**Destinos fiat soportados:**
* USD vía ACH y Wire
* EUR vía SEPA
Para más detalles, consulta la [guía de Offloader Wallets](/es/concepts/automation/offloader-wallets).
### EURC ahora soportado
EURC ahora está disponible en los productos de on-ramp y off-ramp de SpherePay en las redes Base, Ethereum y Solana.
## Suite de API de Clientes para Clientes Empresariales
Soporte completo de API para incorporar y verificar clientes empresariales, incluyendo el registro de UBO — dándote control completo sobre la UX de incorporación sin redirigir a los clientes a un flujo externo.
Nuevos endpoints disponibles:
* [Registrar representante empresarial](/es/api-reference/business-representative/post)
* [Subir documentos de identificación de UBO](/es/api-reference/document/post)
* [Solicitar verificación de vivacidad facial para UBO](/es/api-reference/enhanced-due-diligence/ubo-face-verification-link)
* [Enviar UBO para verificación](/es/concepts/onboarding/business-kyb#poll-for-verification-result)
Para más detalles, consulta la [guía KYB vía API](/es/concepts/onboarding/business-kyb).
## Deprecación de la API de Comisiones de Transferencia
**Acción requerida antes del 14 de enero de 2026.** El endpoint `/v1/transfer/fee` será eliminado el 14 de enero de 2026. Migra antes de esta fecha para evitar interrupciones.
Las comisiones de transferencia ahora se declaran directamente en el cuerpo de la solicitud de transferencia. El endpoint de comisiones independiente ya no es necesario y será retirado.
## Suite de API de Clientes para Clientes Individuales
Soporte completo de API para incorporar y verificar clientes individuales — habilitando flujos KYC de extremo a extremo dentro de tu propio producto sin redirigir a los clientes a una página externa.
Nuevos endpoints disponibles:
* [Subir documentos requeridos](/es/api-reference/document/post)
* [Enviar y verificar OTP por correo](/es/api-reference/enhanced-due-diligence/send-verification-code)
* [Enviar y verificar OTP por teléfono](/es/api-reference/enhanced-due-diligence/send-verification-code)
* [Solicitar verificación de vivacidad facial](/es/api-reference/enhanced-due-diligence/face-verification-link)
El endpoint [Crear Cliente](/es/api-reference/customer/post) ahora acepta los siguientes campos para KYC basado en API:
* `personalInformation.taxIdentificationNumber`
* `personalInformation.taxIdentificationNumberType`
* `personalInformation.taxIdentificationNumberCountry`
* `personalInformation.taxIdentificationNumberDescription`
Para más detalles, consulta la [guía KYC vía API](/es/concepts/onboarding/individual-kyc) o [KYC vía Link](/es/concepts/onboarding/kyc-via-link) para una ruta de integración más rápida.
## API de Onramper Accounts
Los Onramper Accounts generan cuentas bancarias virtuales dedicadas que convierten automáticamente los depósitos fiat entrantes en stablecoins y los entregan on-chain — sin intervención manual requerida.
* Genera cuentas bancarias dedicadas por cliente o aplicación
* Convierte automáticamente depósitos USD/EUR en USDC o USDT
* Entrega los fondos convertidos directamente a cualquier dirección de billetera on-chain
Para más detalles, consulta la [guía de Onramper Accounts](/es/concepts/automation/onramper-accounts).
## Soporte para la Red Starknet
Starknet ahora está soportado para transferencias USDC `onRamp` y `offRamp`. Usa `"network": "starknet"` en el `source` o `destination` de tu solicitud de transferencia.
**Off-ramp vía Starknet:**
```json theme={"dark"}
{
"customer": "customer_098xxxxxxxxxxxxxxxxxxxxxxxxxxxfbb",
"amount": "1.12",
"source": {
"id": "wallet_81bxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx9f3",
"network": "starknet",
"currency": "usdc"
},
"destination": {
"id": "bankAccount_cabxxxxxxxxxxxxxxxxxxxxcxxxxx42c",
"network": "ach",
"currency": "usd"
}
}
```
**On-ramp vía Starknet:**
```json theme={"dark"}
{
"customer": "customer_098xxxxxxxxxxxxxxxxxxxxxxxxxxxfbb",
"amount": "2",
"source": {
"id": "bankAccount_cabxxxxxxxxxxxxxxxxxxxxcxxxxx42c",
"network": "wire",
"currency": "usd"
},
"destination": {
"id": "wallet_81bxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx9f3",
"network": "starknet",
"currency": "usdc"
}
}
```
## Deprecación de `/v1/customer`
**Acción requerida antes del 6 de junio de 2025.** El endpoint `/v1/customer` será deprecado el 6 de junio de 2025. Migra a `/v2/customer` antes de esta fecha.
`/v2/customer` es el nuevo estándar para crear y gestionar clientes y continuará recibiendo nuevas funciones. Consulta la [referencia de la API de Clientes](/es/api-reference/customer/post) para detalles de migración.