Notas de Versión y Changelog de la API de SpherePay

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.

Onboarding/Compliance

Documentos de identidad digitales brasileños

SpherePay ahora acepta dos valores adicionales de documentType en POST /v2/document para documentos de identidad digitales de Brasil:

br_digital_drivers — licencia de conducir digital (CNH digital)
br_digital_id — documento nacional de identidad digital (RG digital)

Estos tipos son válidos solo con country: "BRA". Sube una sola imagen y omite el campo side. Están admitidos para clientes individuales (target: "customer") y representantes empresariales (target: "business_representative"). Los documentos físicos brasileños siguen usando drivers e id_card con anverso y reverso.Para la lista completa de tipos de ID aceptados, consulta Tipos de ID y NIF admitidos.

APICustomersKYC

Nuevo: campos de verificación EEA para clientes individuales

Los clientes individuales residentes en la región EEA+ ahora requieren accountPurpose (campo nuevo), countryOfBirth y nationality bajo personalInformation antes de poder enviarse a verificación.Estos campos son opcionales en la creación y pueden proporcionarse después vía PATCH /v2/customer/{id}. Hasta que se proporcionen, aparecen como códigos de requisito country_of_birth, nationality y account_purpose en el perfil de verificación kyc_profile_a del cliente. Los clientes fuera de EEA+ no se ven afectados.Los clientes EEA+ existentes pueden mostrar estos como requisitos pendientes nuevos. Complétalos con PATCH /v2/customer/{id} — la validación se ejecuta sobre el estado combinado del cliente.Los enlaces de verificación alojados recopilan los datos nuevos automáticamente. Los integradores que usan enlaces alojados no necesitan cambios.Para valores de campos, exigencia y un ejemplo de solicitud, consulta Residentes EEA+.

APICustomersKYB

Nuevo: número de registro empresarial EEA y requisitos ampliados de personas asociadas

Las empresas constituidas en EEA+ deben proporcionar businessInformation.registrationNumber más un registrationNumberType nuevo por país (por ejemplo siren, kvk, crn). El número de registro se almacena y verifica por separado del ID fiscal — no envíes un número de IVA o fiscal como número de registro.Los representantes empresariales admiten un rol director nuevo. ownershipPercentage ahora acepta 0–100 (antes el mínimo era 25); el rol ubo sigue exigiendo ≥ 25. Las empresas EEA+ deben tener al menos una persona de control y completar KYC para todos los directores, firmantes, personas de control y propietarios con ≥ 25%.Los elementos pendientes aparecen como códigos de requisito registration_number, eea_control_person_present y eea_ap_kyc_scope en kyb_profile_a. Los representantes de empresas EEA+ también deben proporcionar countryOfBirth y nationality, que aparecen en el perfil ubo_kyc_profile_a de cada representante.Los clientes y representantes EEA+ existentes pueden mostrar estos como requisitos pendientes nuevos. Complétalos con PATCH /v2/customer/{id} y PATCH /v2/business-representative/{id} — la validación se ejecuta sobre el estado combinado.Los enlaces de verificación alojados recopilan los datos nuevos automáticamente. Los integradores que usan enlaces alojados no necesitan cambios.Para tipos de registro, roles de representantes y códigos de requisito, consulta Empresas EEA+.

TransfersBank Accounts

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í.

Dashboard

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.

DashboardOnboarding/Compliance

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.

Dashboard

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.

DashboardOnboarding/Compliance

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.

TransfersBank AccountsAssets

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 y Rieles y Divisas Soportadas.

TransfersBank Accounts

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.

Onboarding/Compliance

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.

WalletsTransfersAssets

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.

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.

Onboarding/Compliance

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:

Para más detalles, consulta la guía KYB vía API.

Transfers

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.

Onboarding/Compliance

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:

El endpoint Crear Cliente 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 o KYC vía Link para una ruta de integración más rápida.

Bank AccountsWalletsTransfers

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.

WalletsTransfers

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:

{
  "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:

{
  "customer": "customer_098xxxxxxxxxxxxxxxxxxxxxxxxxxxfbb",
  "amount": "2",
  "source": {
    "id": "bankAccount_cabxxxxxxxxxxxxxxxxxxxxcxxxxx42c",
    "network": "wire",
    "currency": "usd"
  },
  "destination": {
    "id": "wallet_81bxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx9f3",
    "network": "starknet",
    "currency": "usdc"
  }
}

Onboarding/Compliance

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 para detalles de migración.

​Documentos de identidad digitales brasileños

​Nuevo: campos de verificación EEA para clientes individuales

​Nuevo: número de registro empresarial EEA y requisitos ampliados de personas asociadas

​Pagos internacionales por SWIFT

​Gestiona offloader wallets desde el dashboard

​Incorpora a tus clientes y consulta sus cuentas externas

​Agrega cuentas y crea transferencias en nombre de tus clientes

​Navegación del Dashboard Rediseñada y Flujo de Transferencias

​Transferencias BRL/PIX Ahora Soportadas

​Pagos Wire con Nombre

​Incorporación API-First por Defecto

​API de Offloader Wallets + Soporte para EURC

​API de Offloader Wallets

​EURC ahora soportado

​Suite de API de Clientes para Clientes Empresariales

​Deprecación de la API de Comisiones de Transferencia

​Suite de API de Clientes para Clientes Individuales

​API de Onramper Accounts

​Soporte para la Red Starknet

​Deprecación de /v1/customer

Documentos de identidad digitales brasileños

Nuevo: campos de verificación EEA para clientes individuales

Nuevo: número de registro empresarial EEA y requisitos ampliados de personas asociadas

Pagos internacionales por SWIFT

Gestiona offloader wallets desde el dashboard

Incorpora a tus clientes y consulta sus cuentas externas

Agrega cuentas y crea transferencias en nombre de tus clientes

Navegación del Dashboard Rediseñada y Flujo de Transferencias

Transferencias BRL/PIX Ahora Soportadas

Pagos Wire con Nombre

Incorporación API-First por Defecto

API de Offloader Wallets + Soporte para EURC

API de Offloader Wallets

EURC ahora soportado

Suite de API de Clientes para Clientes Empresariales

Deprecación de la API de Comisiones de Transferencia

Suite de API de Clientes para Clientes Individuales

API de Onramper Accounts

Soporte para la Red Starknet

Deprecación de `/v1/customer`