Skip to main content
Esta página muestra los cambios fechados de la API de Swipelux. Cada entrada indica la versión afectada, el tipo de cambio y cualquier acción requerida por parte de los integradores. Para actualizar una integración existente desde una versión anterior, consulta Migrar a v3.

Sin publicar

Los próximos cambios se listarán aquí antes de su lanzamiento.

2026-09-08

Versión: v3

Cambiado

  • POST /v3/transfers y las lecturas de transferencias usan checkoutMethod en lugar de paymentMethod para la preselección del checkout de tarjeta, y aceptan card, apple_pay, google_pay, cash_app, sepa y blik. La lista es abierta y puede crecer. paymentMethod ya no se reconoce; las solicitudes que aún lo envían se tratan como si se hubiera omitido. sepa y blik son opciones de pago dentro del checkout de tarjeta, no capacidades de Swipelux. Consulta Recibir fondos.

2026-09-07

Versión: v3

Añadido

  • POST /v3/transfers acepta un paymentMethod opcional con el valor card, apple_pay o google_pay para cotizaciones de tarjeta. El checkout alojado se abre con el método solicitado cuando está disponible para el cliente y su dispositivo, las lecturas de la transferencia devuelven la solicitud, y los importes y las comisiones de la cotización no cambian. Consulta Recibir fondos.

2026-08-31

Versión: v3

Añadido

  • Solicitar una capacidad para una empresa sin beneficiario efectivo ahora crea una tarea de admisión para añadir uno en lugar de fallar con un 503. Las solicitudes que no pueden continuar devuelven 422 beneficial_owner_required con instrucciones para añadir una parte relacionada individual con una participación declarada o de al menos el 25 %. Consulta Accionistas, UBO y personas de control.
  • La tabla de tareas del panel de comercio ahora muestra el sujeto y el ámbito de capacidad de cada solicitud, de modo que puedes ver a quién y qué cubre una solicitud de cumplimiento. Consulta Capacidades y requisitos.
  • Los campos de clasificación industrial del panel de comercio ahora ofrecen códigos NAICS con búsqueda en los perfiles de cliente y en las tareas de requisitos. Consulta Flujo de KYB.

Cambiado

  • Los envíos de datos bancarios que entran en conflicto con una configuración bancaria en curso ahora devuelven 409 ops_rail_handoff_conflict. Conserva los identificadores de los documentos subidos y reintenta el mismo envío cuando el conflicto se haya resuelto, en lugar de volver a subir los documentos. Consulta Errores y reintentos.
  • El mínimo para depósitos de stablecoins no anunciados en los monederos de los clientes ahora es de 1 unidad en lugar de 10. Los depósitos más pequeños se siguen tratando como residuales. Consulta Recibir fondos.
  • La configuración de webhooks ahora está aislada por entorno. El portal de webhooks se abre limitado al entorno desde el que lo solicitas, por lo que los endpoints de sandbox y de producción ya no comparten ajustes. Consulta Webhooks.
  • El panel de comercio ahora deriva los métodos de pay-in disponibles de las capacidades v3 del cliente, por lo que la configuración de cuentas solo ofrece métodos a los que el cliente tiene derecho. Consulta Cuentas.
  • Los formularios RFI ahora recopilan los beneficiarios efectivos que cumplen los requisitos con indicaciones más cortas y claras, y el historial de RFI se muestra como hitos del ciclo de vida. Consulta Requisitos de documentos.

Eliminado

  • El panel de comercio ya no ofrece Fedwire al añadir nuevos métodos de pay-in. Las cuentas Fedwire existentes siguen siendo legibles. Consulta Cuentas.

Corregido

  • Los depósitos de USDT no anunciados en los monederos de los clientes ahora se reconocen y se liquidan en lugar de ignorarse.
  • Las evidencias que ya has enviado ahora se trasladan a otras tareas que requieren el mismo elemento, por lo que no se pide a los clientes el mismo documento dos veces.
  • Volver a solicitar una capacidad ya no descarta las rutas bancarias que ya están listas, por lo que los datos de las cuentas emitidas se mantienen estables.
  • Las vistas de instrucciones bancarias del panel de comercio ahora muestran los datos completos, incluidas las direcciones SWIFT y la dirección del monedero de destino.
  • Los formularios RFI ahora muestran los errores de validación del envío, validan las descripciones de la forma jurídica antes del envío y aceptan varios sitios web de la empresa.
  • Ahora puedes editar los borradores de personas relacionadas en los formularios RFI antes de enviarlos.
  • Las solicitudes de cumplimiento canceladas ya no aparecen en la lista de tareas del panel de comercio.
  • Los estados de revisión de documentos vuelven a mostrarse correctamente en el panel de comercio.

2026-08-24

Versión: v3

Añadido

  • Las sesiones alojadas de verificación y de Términos del servicio con ámbito de cliente ahora incluyen un objeto action autoritativo. Sigue su tipo available o unavailable; los campos planos url y expiresAt se mantienen como reflejos de compatibilidad para las acciones disponibles. Consulta Capacidades y requisitos.
  • Las recargas de monederos en el sandbox ahora devuelven identificadores de transferencia que puedes consultar con GET /v3/transfers/{transferId} o listar con GET /v3/transfers. Aparecen como depósitos entrantes de stablecoins completados. Consulta Pruebas en el sandbox.

Cambiado

  • El recorrido First pay-in del panel de comercio para tarjetas y Apple Pay ahora requiere un monedero Polygon del cliente. Créalo antes de iniciar el recorrido. Consulta Cuentas.
  • Las solicitudes nuevas y las respuestas públicas utilizan sepa como nombre canónico del método y la capacidad. El alias de entrada sepa_instant y los recursos almacenados anteriormente siguen siendo compatibles, pero las respuestas públicas utilizan sepa. Consulta Cuentas.
  • Las nuevas solicitudes de capacidad, cuenta emitida y cotización de Faster Payments no están disponibles. Las cuentas, cotizaciones y transferencias existentes siguen siendo legibles. Consulta Cuentas.
  • La primera página de KYB ya no recopila la fecha de nacimiento del representante. Las fechas de nacimiento de los accionistas siguen siendo un requisito independiente. Consulta Flujo de KYB.
  • Las referencias de documentos RFI ahora aceptan el alias MIME image/jpg además de image/jpeg. Consulta Requisitos de documentos.
  • El historial de tareas del panel de comercio ahora muestra un registro de auditoría legible sin contadores de revisión. Consulta Capacidades y requisitos.

Eliminado

  • El panel de comercio ya no ofrece la configuración de nuevas cuentas UAEFTS. Las cuentas UAEFTS existentes siguen siendo legibles. Consulta Cuentas.

Corregido

  • Los formularios RFI conservan las entradas existentes cuando un revisor añade una nueva entrega de documentos, por lo que las respuestas anteriores no se pierden al volver a enviar.
  • El panel de comercio reanuda las sesiones alojadas de cumplimiento desde las acciones disponibles sin descartar enlaces válidos.
  • Los enlaces alojados a los Términos del servicio ahora funcionan para todos los ámbitos de tarea que devuelve la API.
  • Después de solicitar Payment Access en el panel de comercio, se abre la tarea de admisión devuelta por esa solicitud en lugar de una tarea de una solicitud anterior.
  • La demostración de KYB del panel de comercio ahora solicita los campos obligatorios actuales.
  • Una cotización que reutiliza su monedero de origen como destinationId ahora devuelve detalles útiles de 422 quote_direction_invalid antes de iniciar cualquier trabajo del proveedor. Consulta Cotizaciones y transferencias.
  • La API rechaza la codificación incorrecta de la cadena de consulta con un error 400 en lugar de normalizar silenciosamente la solicitud. Consulta Errores y reintentos.
  • POST /v3/customers/{customerId}/documents ahora rechaza los cuerpos de solicitud vacíos, que no sean multipart o que estén mal formados con un error 400.

2026-08-17

Versión: v3

Añadido

  • Se publicó el catálogo de Problem Details de v3 en la especificación OpenAPI para que los integradores puedan asignar las respuestas de error directamente desde el esquema. Errors.
  • Se añadió customerId a los eventos webhook de cuenta en v3, lo que te permite correlacionar la actividad de cuenta con el cliente propietario sin una lectura adicional. Consulta Webhooks.
  • Cobertura completa de los campos del perfil individual en V3 en el panel del comerciante, para que los operadores de onboarding puedan revisar y editar cada campo KYC recopilado a través de la API v3. Consulta Clientes.
  • Se publicó una guía de migración para desarrolladores de v3. Consulta Migrar a v3.

Cambiado

  • Los códigos de país de clientes y cuentas ahora se validan como valores ISO 3166-1 alpha-2 asignados en el momento de la escritura. Las lecturas toleran los valores heredados almacenados para que los registros existentes sigan resolviéndose. Consulta Cuentas y carteras.
  • La disponibilidad de USDC en ahora se limita según la red de destino, por lo que las cotizaciones y transferencias solo ofrecen USDC en las redes que el destino realmente admite.
  • Capability.ready indica que el derecho está aprobado, no que exista una cuenta emitida. Usa accountProvisioning para seguir la emisión de la cuenta: not_applicable, not_started, in_progress, issued o failed.
  • Ahora se aceptan las subidas HEIC desde iPhone como documentos de identidad y de domicilio.

Corregido

  • Volver a ejecutar una cotización ya consumida ahora devuelve 409 quote_execution_consumed en lugar de un error genérico. Consulta Cotizaciones y transferencias.
  • Las lecturas de la lista de transferencias y de los importes de cotización ya no devuelven 500 en resultados históricos grandes.
  • Las lecturas de partes relacionadas para clientes individuales ya no devuelven 404.
  • Las filas de enlaces de verificación en el panel del comerciante ahora muestran una acción Open en cada fila, y cada enlace de tarea de infraestructura de wallet se representa en la vista de requisitos.