Resumen
Consulta cuentas de comerciante, transacciones, liquidaciones, checkouts, recibos, lectores de tarjetas, miembros del equipo y subcuentas de SumUp desde cualquier agente de IA. Solo lectura, con autenticación mediante token Bearer.
Configuración guiada
Conecta SumUp a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta SumUp con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para SumUp
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → SumUp, pega tus credenciales y genera una clave de API de MCP: listo. Sin Docker, sin
git clone, sin servidor local.
SumUp
Consulta cuentas de comerciante, transacciones, liquidaciones, checkouts, recibos, lectores de tarjetas, miembros del equipo y subcuentas de SumUp desde cualquier agente de IA. Solo lectura, con autenticación mediante token Bearer.
Configuración
La configuración lleva unos 2 minutos. Necesitas una cuenta de comerciante de SumUp y una clave de API de esa cuenta.
- Inicia sesión en el panel de SumUp en https://me.sumup.com.
- Abre Settings → For Developers (o el Developer Portal).
- Genera una clave de API (Personal Access Token) y pégala en
SUMUP_API_KEY. Se envía como token Bearer en cada llamada. - Instala el conector y ejecuta
sumup_get_merchant_profile: devuelve el código de comerciante, el nombre de la empresa, la moneda y el país de la cuenta asociada a la clave, lo que demuestra que la clave funciona.
Qué lee: el perfil del comerciante; el historial de transacciones, por defecto de la más reciente a la más antigua, filtrado por estado (como SUCCESSFUL, CANCELLED o FAILED) o limitado a las transacciones modificadas desde una marca de tiempo ISO 8601, con hasta 100 por página; una transacción concreta por su id o por su código de transacción (como TD6Q7P2); las liquidaciones a tu cuenta bancaria entre dos fechas (YYYY-MM-DD); los checkouts en línea y los enlaces de pago, filtrados por tu propia referencia de checkout; y las subcuentas de operador de la cuenta principal.
Código de comerciante, recibos, equipo y lectores de tarjetas: las versiones actuales de la API de SumUp identifican una cuenta por su código de comerciante, que devuelve sumup_get_merchant_profile; si la clave llega a varias cuentas, sumup_list_memberships las enumera y sumup_get_merchant muestra una. Con ese código la IA también lee las transacciones y las liquidaciones en las versiones actuales de la API (las liquidaciones incluyen deducciones como reembolsos y contracargos), el recibo de una transacción, un checkout en línea concreto, los métodos de pago ofrecidos en línea, los clientes guardados y sus tarjetas tokenizadas (solo los cuatro últimos dígitos), los miembros, los roles personalizados y las personas registradas (titulares, representantes legales), y los lectores de tarjetas vinculados con su estado en directo y el checkout enviado a cada uno. Las herramientas anteriores de transacciones y liquidaciones se mantienen para las configuraciones existentes. Un 403 significa que el usuario de la clave no tiene en SumUp el permiso para esa cuenta.
Solo lectura: las 26 herramientas solo leen. No se modifica nada en tu cuenta de SumUp; los reembolsos, los checkouts nuevos, los cobros en el lector y los cambios de miembros se hacen en el panel de SumUp.
¿Ya lo tienes instalado? Las nuevas herramientas llegan a un conector instalado antes a través de su actualización de catálogo: abre el conector en AnythingMCP y, en Catalog update available, revisa la lista de herramientas nuevas y haz clic en Apply update. Tus credenciales y las herramientas que añadiste tú se quedan como están.
Requisitos previos: SUMUP_API_KEY
Instala el conector en local
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Abre http://localhost:3000/connectors/store, elige SumUp y pega las variables de entorno indicadas en Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
sumup_get_merchant_profile | Recupera el perfil del comerciante y la información de la cuenta asociada a la clave de API autenticada, incluidos el código de comerciante, el nombre de la empresa… |
sumup_list_transactions | Lista el historial de transacciones de la cuenta de comerciante autenticada con filtros por rango de fechas, estado del pago y paginación |
sumup_get_transaction | Recupera la información detallada de una transacción concreta por su ID o su código de transacción |
sumup_list_payouts | Recupera el historial de pagos y los informes de liquidación transferidos a la cuenta bancaria del comerciante, filtrados por rango de fechas |
sumup_list_checkouts | Lista los checkouts en línea y los enlaces de pago generados para los clientes, con filtros opcionales por estado y referencia de checkout |
sumup_list_subaccounts | Recupera las subcuentas de operador configuradas bajo la cuenta de comerciante principal |
sumup_list_memberships | Lista las cuentas de comerciante (y organizaciones) a las que pertenece el usuario de la clave de API, con el código de comerciante como resource.id, el nombre de la cuenta… |
sumup_get_merchant | Recupera una cuenta de comerciante por su código: nombre de la empresa y datos legales, tipo y perfil de negocio, país, moneda y configuración regional predeterminadas… |
sumup_list_merchant_payouts | Lista los pagos (payouts) a la cuenta bancaria del comerciante entre dos fechas (API v1.0 actual): fecha del pago, importe, comisión, moneda, estado, referencia… |
sumup_list_merchant_transactions | Lista las transacciones del comerciante (API v2.1 actual): pagos con tarjeta, en efectivo y en línea, reembolsos y contracargos con importe, moneda, estado… |
sumup_get_merchant_transaction | Recupera todos los detalles de una transacción (API v2.1 actual): importe, IVA, propina, comisión, estado, tarjeta y modo de entrada, productos, plan de pagos… |
sumup_get_receipt | Recupera el recibo estructurado de una transacción: datos del comerciante, datos de la transacción con productos e IVA, datos de la tarjeta (EMV) y del adquirente |
sumup_get_checkout | Recupera un checkout en línea por su id: importe, moneda, estado (PENDING, PAID, FAILED, EXPIRED), referencia de checkout, descripción… |
sumup_get_customer | Recupera un cliente guardado (usado para pagos en línea recurrentes o tokenizados) por el id de cliente que asignaste: datos personales como el nombre… |
sumup_list_payment_instruments | Lista los instrumentos de pago guardados de un cliente: token de la tarjeta, tipo de tarjeta y datos enmascarados, mandato, fecha de creación… |
sumup_list_payment_methods | Lista los métodos de pago disponibles para el comerciante en los checkouts en línea (tarjetas, Apple Pay, Google Pay, iDEAL, Bancontact y otros)… |
sumup_list_members | Lista los miembros (usuarios) de una cuenta de comerciante con correo electrónico, roles, estado (accepted, pending…) y permisos |
sumup_get_member | Recupera un miembro de una cuenta de comerciante: usuario, correo electrónico, roles, permisos, estado y marcas de tiempo |
sumup_list_roles | Lista los roles personalizados de una cuenta de comerciante con sus nombres y permisos, para explicar qué permite el rol de un miembro |
sumup_get_role | Recupera un rol personalizado de una cuenta de comerciante con sus permisos |
sumup_list_persons | Lista las personas registradas en una cuenta de comerciante (representantes legales, propietarios y otras personas de la empresa)… |
sumup_get_person | Recupera una persona registrada en una cuenta de comerciante |
sumup_list_readers | Lista los lectores de tarjetas (p. ej. SumUp Solo) vinculados a la cuenta de comerciante: id, nombre, estado, modelo e identificador del dispositivo |
sumup_get_reader | Recupera un lector de tarjetas vinculado: nombre, estado, modelo e identificador del dispositivo, metadatos y marcas de tiempo |
sumup_get_reader_status | Recupera el estado en tiempo real de un lector de tarjetas: en línea o fuera de línea, nivel de batería, tipo de conexión, firmware y estado del checkout en curso |
sumup_get_reader_checkout | Recupera un checkout enviado a un lector de tarjetas: importe, estado y la transacción resultante |
Siguientes pasos
¿Te ha sido útil esta guía?