¿Cómo integrar la API de SumUp?

SumUp es una empresa líder en tecnología de pagos utilizada por millones de comerciantes en toda Europa y más allá para aceptar pagos con tarjeta en tienda y en línea. Para las empresas de software que sirven a comerciantes pyme, una integración con SumUp desbloquea flujos de datos financieros potentes directamente dentro de tu producto.

Integrar la API de SumUp te permite:

• Recuperar automáticamente datos de transacciones y pagos para reconciliación o reportes
• Acceder a información de comerciantes y clientes para alimentar flujos de trabajo financieros
• Sincronizar datos de pago con software contable para automatizar la contabilidad
• Construir herramientas de préstamo o gestión de tesorería sobre datos de ventas reales

Esta guía cubre todo lo que necesitas saber sobre la API de SumUp: configuración técnica, mejores prácticas y cómo la API de TPV Unificada de Chift te ayuda a evitar el trabajo más pesado.

¿Qué es la API de SumUp?

SumUp expone varias superficies de API distintas, todas basadas en REST. En Chift, utilizamos la Core REST API, que impulsa nuestro conector de SumUp y cubre los principales flujos de datos transaccionales y de comerciantes.

La API se comunica en JSON sobre HTTP estándar, utilizando URLs orientadas a recursos y códigos de estado HTTP convencionales. La URL base es https://api.sumup.com.

Los principales grupos de recursos disponibles a través de la API incluyen:

• Transactions (Transacciones): registros individuales de pagos con tarjeta
• Payouts (Pagos): datos de liquidación enviados a las cuentas bancarias de los comerciantes
• Checkouts: sesiones de pago en línea
• Customers (Clientes): perfiles de clientes almacenados
• Receipts (Recibos): datos de recibos digitales
• Readers (Lectores): gestión de terminales de tarjeta (hardware)
• Merchants (Comerciantes): datos de cuenta y perfil del comerciante
• Members, Memberships, Roles: gestión de usuarios y accesos
• Subaccounts (Subcuentas): estructuras de comerciantes con múltiples ubicaciones

En Chift, utilizamos principalmente la API de SumUp para leer transacciones, pagos y datos de comerciantes, los tres tipos de datos que impulsan la mayoría de los casos de uso de pagos-contabilidad y pagos-fintech.

La autenticación se gestiona mediante OAuth2. Para conectarse, el cliente debe proporcionar un Client ID y un Client Secret, que se utilizan para obtener tokens de acceso en las llamadas a la API.

Para la referencia técnica completa, consulta la documentación de la API de SumUp.

{{CTA-1}}

Ejemplos de casos de uso de la integración API de SumUp

Reconciliación automática de transacciones para plataformas contables

Las soluciones de contabilidad y pre-contabilidad pueden extraer datos de transacciones de SumUp a través de Chift para reconciliar automáticamente los pagos con tarjeta con facturas o asientos contables. Esto elimina las exportaciones manuales de CSV y reduce significativamente el trabajo administrativo de fin del día para los comerciantes y sus contables.

Visibilidad de tesorería para herramientas de gestión financiera

Las herramientas de gestión de tesorería y previsión financiera pueden usar los datos de pagos de SumUp para dar a los comerciantes una visión en tiempo real de los fondos entrantes. En lugar de esperar los extractos bancarios, tu producto puede mostrar lo que se ha procesado, liquidado y está pendiente, todo en un solo lugar.

Datos de transacciones para plataformas de préstamo a empresas

Los prestamistas empresariales y las plataformas fintech pueden usar el historial de transacciones de SumUp para evaluar los ingresos de los comerciantes, identificar tendencias y tomar decisiones de crédito basadas en datos. Los datos de ventas reales de un terminal de tarjeta están entre las señales más fiables de la salud de un negocio, lo que convierte a SumUp en una fuente valiosa para los flujos de préstamo integrado.

‍

Para más ejemplos de cómo las integraciones de pagos pueden mejorar tu producto, explora nuestros casos de estudio de Chift.

Configuración de tu integración API de SumUp

Para conectarte a la API de SumUp, necesitas configurar una aplicación OAuth2 y obtener credenciales desde el portal de desarrolladores de SumUp.

Cómo empezar:

1. Crea una cuenta de desarrollador en developer.sumup.com.
2. Registra tu aplicación para recibir un Client ID y un Client Secret.
3. Implementa el flujo de autorización OAuth2 para obtener tokens de acceso en nombre de tus comerciantes.
4. Usa el token de acceso en el encabezado Authorization: Bearer en cada solicitud a la API.
5. Gestiona la lógica de renovación del token para mantener un acceso persistente sin necesidad de reautenticación.

Aunque la API de SumUp está bien documentada y es accesible, las integraciones en producción requieren mucho más que una conexión básica. Necesitarás gestionar el ciclo de vida de los tokens, la normalización de datos entre comerciantes, arquitecturas multi-tenant, gestión de errores y mantenimiento continuo de la API.

Mejores prácticas para la integración API de SumUp

• Usa los endpoints versionados y no obsoletos. SumUp expone versiones actuales y obsoletas para transacciones y pagos (ej. /api/transactions/list vs /api/transactions/list-deprecated). Usa siempre las rutas no obsoletas: devuelven datos más ricos y seguirán siendo compatibles.
• Almacena las credenciales de forma segura. Las claves API y las credenciales OAuth deben almacenarse en variables de entorno, nunca codificadas en tu aplicación. No las expongas nunca en código del lado del cliente, repositorios públicos o entornos de navegador.
• Implementa backoff exponencial para errores de rate limiting. SumUp no publica límites numéricos específicos, pero la API devuelve 429 Too Many Requests cuando se superan los límites. Construye lógica de reintento con backoff exponencial para manejar estos casos correctamente.
• Normaliza los datos de comerciantes desde el principio. Los modelos de datos de comerciantes pueden variar entre subcuentas y contextos de integración. Estandariza tu modelo de datos interno desde el inicio para evitar inconsistencias posteriores, especialmente si conectas múltiples comerciantes a través del mismo pipeline.
• Limita los permisos OAuth al mínimo necesario. Solicita solo los scopes OAuth que tu integración realmente necesita. Esto reduce el riesgo de seguridad y mantiene tu aplicación alineada con los principios de mínimo privilegio.

¿Por qué integrar SumUp a través de Chift?

Construir una integración directa con SumUp es sencillo al principio. Pero una vez que has gestionado la lógica de renovación de tokens OAuth2, la paginación, los reintentos por límites de velocidad, la normalización de datos entre comerciantes y las inevitables deprecaciones de endpoints, todavía necesitas mantener todo eso a medida que la API evoluciona. Y luego hacer lo mismo con cada otra herramienta de pago en tu hoja de ruta.

Con la API de Pagos Unificada de Chift, integras una vez y accedes a SumUp, Stripe, Mollie, Square, MyPOS y muchas más, todo a través del mismo modelo de datos normalizado.

Esto es lo que desbloquea para tu equipo:

• Tu equipo de ingeniería construye una sola integración y sigue enfocado en tu producto principal
• Los nuevos conectores se activan en un clic, sin trabajo de desarrollo adicional
• La autenticación, el manejo de errores y el mapeo de datos están completamente gestionados por Chift
• Monitoreo integrado, registro y mantenimiento a largo plazo incluidos
• Soporte experto de un equipo que entiende tanto los aspectos técnicos como de negocio de las integraciones financieras

Tu equipo de desarrollo ahorra tiempo. Tu equipo comercial puede decir sí a más solicitudes de integración. Y tu producto se convierte en la opción obvia para los clientes que necesitan que sus datos de pago fluyan.

¿Quieres ver cómo Chift conecta tu producto a SumUp y más de 50 otras herramientas financieras? Contacta con nuestro equipo para descubrir más.

FAQ de la integración API de SumUp

¿Qué endpoints incluye la API de SumUp a través de Chift?

El conector de SumUp de Chift expone un conjunto estandarizado de endpoints que cubren los datos de pago más importantes, incluyendo (entre otros):

• Transacciones /transactions
• Pagos /payouts
• Comerciantes /merchants

Consulta nuestra documentación de la API de SumUp para ver la lista completa de rutas disponibles.

¿Cuáles son los límites de velocidad de la API de SumUp?

SumUp no publica límites numéricos específicos en su documentación oficial. La API devuelve 429 Too Many Requests cuando se superan los límites. La gestión recomendada es implementar lógica de reintento con backoff exponencial. Aumenta progresivamente el tiempo entre reintentos en lugar de volver a intentarlo de inmediato.

¿Qué API de pago es gratuita?

La API de SumUp no tiene cuota de acceso ni de suscripción: solo pagas por transacción procesada. Stripe, Square y PayPal siguen el mismo modelo. Las API de pago verdaderamente gratuitas (sin comisión por transacción) no existen para el procesamiento comercial de tarjetas, ya que las comisiones de intercambio siempre deben ser cubiertas. Algunas API de transferencia bancaria u open banking, como GoCardless, pueden ofrecer tarifas muy bajas como alternativa.

¿Quién es el propietario de SumUp?

SumUp es una empresa fintech privada respaldada por sus fundadores y un consorcio de inversores institucionales globales.

¿De qué país es SumUp?

SumUp es una empresa de tecnología financiera británica con sede en Londres, con una fuerte presencia en Europa y en mercados internacionales.

¿Qué porcentaje cobra SumUp?

Para los pagos presenciales, la comisión estándar de SumUp es del 1,69 %. Para los pagos en línea (enlaces de pago, reservas, productos digitales), la comisión es del 2,50 % por transacción. Con la suscripción Payments Plus (19 £/mes), la tarifa presencial baja al 0,99 % para tarjetas de consumo domésticas (las tarjetas internacionales, corporativas y AMEX se mantienen al 1,69 %). No hay cuotas de instalación, cuotas mensuales en el plan estándar ni cargos por transacciones rechazadas. Consulta la página de precios de SumUp para más detalles.

¿Se puede integrar SumUp con Shopify?

Sí, pero no de forma nativa. Requiere un conector de terceros. SumUp y Shopify no tienen una integración nativa directa, por lo que conectar ambos suele implicar una capa de middleware o un conector de terceros.

¿Puede SumUp integrarse con otras aplicaciones?

Sí. SumUp permite a terceros integrar su infraestructura de pago de extremo a extremo a través de su API de desarrollador, lo que permite una amplia variedad de integraciones con herramientas de contabilidad, ERP, CRM y fintech.

¿Qué software contable funciona con SumUp?

SumUp tiene una alianza oficial con Xero, que permite a los comerciantes sincronizar su historial de ventas sin coste adicional (los suscriptores de SumUp One también obtienen un descuento exclusivo del 90 % en sus primeros seis meses de Xero). SumUp POS también se integra con QuickBooks, permitiendo a los usuarios sincronizar datos de ventas para declaraciones de IVA e informes financieros directamente desde su panel. Para una conectividad contable más amplia con otras plataformas, la API de Pagos Unificada de Chift puede conectar los datos de SumUp con herramientas contables adicionales.