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

​

Transferencias MXN/SPEI ahora soportadas vía API

• SPEI MXN → Wire USD (nacional)
• SPEI MXN → SWIFT USD (internacional)
• Límites de transferencia: $50–$1,000,000 USD por transferencia

• Las transferencias deben crearse a partir de una cotización — llama a POST /v2/quote y luego envía el quoteId devuelto a POST /v2/transfer.
• Las comisiones de integrador no están soportadas para transferencias en MXN.
• MXN a USD es la única dirección soportada.
• Las cuentas bancarias SPEI requieren currency: "mxn" y networks: ["spei"].

​

Perfiles de verificación a nivel de cliente

• enabledVerificationProfiles — un arreglo de letras de perfil, por ejemplo ["a", "c"]. Envíalo al crear para elegir los perfiles del cliente; envía el arreglo nuevo completo en un PATCH para agregar un perfil más tarde. Si omites el campo, el cliente se inscribe en todos los perfiles habilitados para tu aplicación al momento de la creación. El perfil D requiere el perfil C en el mismo cliente. La selección de perfiles aplica a los clientes incorporados por API; los enlaces KYC alojados usan los perfiles predeterminados de tu aplicación.
• Inscripción explícita en nuevos perfiles — cuando SpherePay habilita un nuevo perfil para tu aplicación, los clientes existentes no se inscriben automáticamente. Agrega el perfil por cliente cuando lo necesite.
• Requisitos por perfil — cada entrada en verificationProfiles ahora lleva su propio criteria.required, y cada perfil se decide de forma independiente.
• Agrega perfiles a clientes existentes, incluidos los aprobados — PATCH /v2/customer/{id} con el arreglo nuevo funciona ya sea que los demás perfiles del cliente estén en incomplete, pending o approved. Los campos que un perfil en pending o approved ya evaluó permanecen bloqueados; un PATCH que toque uno de ellos devuelve el nuevo 400 customer/field-locked-by-verification-profile, que lista cada campo bloqueado y el perfil que lo bloquea. Consulta Cuándo se pueden actualizar los datos del cliente.
• Eliminar un perfil solo está permitido mientras esté en incomplete; una vez en pending o approved la solicitud devuelve el mismo error.
• Nuevos códigos de error — customer/verification-profile-family-not-enabled-for-application cuando el arreglo nombra un perfil para el que tu aplicación no está habilitada, y customer/verification-profile-not-enabled cuando ninguno de los perfiles seleccionados aplica al país del cliente.

​

Documentos de identidad digitales brasileños

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

​

Nuevo: campos de verificación EEA para clientes individuales

​

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

​

Nuevo: statusHistory en las respuestas de transferencias

"statusHistory": [
  { "status": "pendingFunding", "transitionedAt": "2026-06-20T14:03:21.000Z" },
  { "status": "processing", "transitionedAt": "2026-06-20T14:05:10.000Z" }
]

​

Pagos internacionales por 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)

​

Gestiona offloader wallets 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

• 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

• 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

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

​

Transferencias BRL/PIX Ahora 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

• 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"].

​

Pagos Wire con Nombre

​

Incorporación API-First por Defecto

​

API de Offloader Wallets + Soporte para EURC

​

API de Offloader Wallets

• USDC en Arbitrum, Avalanche, Base, Ethereum, Polygon y Solana
• USDT en Ethereum y Tron
• EURC en Base, Ethereum y Solana

• USD vía ACH y Wire
• EUR vía SEPA

​

EURC ahora soportado

​

Suite de API de Clientes para Clientes Empresariales

• Registrar representante empresarial
• Subir documentos de identificación de UBO
• Solicitar verificación de vivacidad facial para UBO
• Enviar UBO para verificación

​

Deprecación de la API de Comisiones de Transferencia

​

Suite de API de Clientes para Clientes Individuales

• Subir documentos requeridos
• Enviar y verificar OTP por correo
• Enviar y verificar OTP por teléfono
• Solicitar verificación de vivacidad facial

• personalInformation.taxIdentificationNumber
• personalInformation.taxIdentificationNumberType
• personalInformation.taxIdentificationNumberCountry
• personalInformation.taxIdentificationNumberDescription

​

API de Onramper Accounts

• 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

​

Soporte para la Red Starknet

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

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