noon payments a MCP: estado de pedidos, reportes de liquidación y reembolsos en cualquier agente de IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → noon payments, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

noon payments

noon payments, la pasarela de pago para Emiratos Árabes Unidos, Arabia Saudí y Egipto: estado de pedidos por id de pedido o referencia del comercio con totales autorizados, capturados y reembolsados y transacciones, reportes programados de liquidación y comisiones, suscripciones y tokens de tarjeta. Captura y reembolso están incluidos, pero desactivados al instalar.

Configuración

La configuración lleva unos 5 minutos. Necesitas acceso al Merchant Portal de noon payments.

1. En el Merchant Portal abre Account Settings > Applications. Crea una application, o usa una existente, solo con los roles que necesita: Payment Integrator o Refund Manager para consultar pedidos, Financial Auditor para los reportes, Token Manager para los tokens de tarjeta.
2. Arma la clave BusinessIdentifier.ApplicationIdentifier:ApplicationKey: el business identifier del correo de alta, un punto, el application identifier, dos puntos y la application key. Codifícala en Base64, por ejemplo con printf '%s' 'mybusiness.myapp:KEY' | base64, y pega solo el texto Base64 en NOON_PAYMENTS_AUTH_KEY, sin la palabra Key. El conector envía Authorization: Key <ese texto>.
3. Define NOON_PAYMENTS_API_URL como https://api.noonpayments.com (global, producción) o https://api-test.noonpayments.com (prueba). Los endpoints regionales son https://api.sa.noonpayments.com y https://api.eg.noonpayments.com, con las variantes de prueba https://api-test.sa.noonpayments.com y https://api-test.eg.noonpayments.com. Solo el endpoint, sin /payment/v1. Las claves son distintas en cada entorno.
4. Instala el conector y consulta un pedido reciente con noon_payments_get_order_by_reference y el número de pedido de la tienda para comprobar la clave.

Id de pedido y referencia de pedido: order_id es el id numérico que noon devolvió al iniciar el pago, guardado con el pedido de la tienda (a menudo como id de transacción del pago). order_reference es tu propia referencia enviada en ese momento, normalmente el número de pedido de la tienda. Si varios pedidos comparten una referencia (reintentos), se devuelve el más reciente; el id de pedido da una coincidencia exacta.

Qué lee: un pedido por su id o por tu referencia, con su estado (INITIATED, AUTHORIZED, CAPTURED, PARTIALLY_CAPTURED, REFUNDED, REVERSED, CANCELLED, FAILED, MARKED_FOR_REVIEW y otros), monto y moneda, los totales autorizados, capturados, reembolsados, revertidos y pendientes, las transacciones (AUTHORIZATION, CAPTURE, REFUND y otras, cada una con estado, monto, hora e id), los datos de pago enmascarados y las siguientes acciones; los reportes programados que noon generó para un día o un mes, cada uno con un enlace temporal para descargar el ZIP (Excel o separado por tabulaciones); una suscripción recurrente con fecha de creación, estado, vigencia, monto y calendario; y la tarjeta enmascarada detrás de un token de tarjeta guardado (marca, número enmascarado, vencimiento, titular, estado).

Leer un pedido: resultCode 0 solo significa que la solicitud funcionó, no que el pago se completara. La IA juzga por el estado del pedido y nextActions.

Conciliación: ReconciliationSettlement es un reporte diario de las capturas y los reembolsos que hay que conciliar con la liquidación bancaria; ActiveSubscriptions, PaymentTokens, MerchantCommissions y MerchantCommissionDetails son mensuales. Para la liquidación de un día, la IA lista los reportes programados con report_type ReconciliationSettlement y ese día, y tú descargas el archivo desde ReportUrl antes de que caduque el enlace. Para conciliar no recorre los pedidos uno por uno, porque noon limita las consultas repetidas.

Desactivadas al instalar: noon_payments_capture_order (captura un pedido AUTHORIZED total o parcialmente para que los fondos pasen a la cuenta del comercio) y noon_payments_refund_order (reembolsa una captura a la tarjeta del cliente, con el id de la transacción CAPTURE del pedido; no se puede deshacer y requiere el rol Refund Manager). Ambas mueven dinero, así que un administrador las activa a propósito. Incluso entonces la IA te muestra el pedido, el monto y la moneda y espera tu sí, y pasa un transaction_reference para que un reintento no se ejecute dos veces.

Límites: no hay un endpoint para listar o buscar pedidos, así que la IA los consulta por id o referencia, o usa los reportes diarios. Las consultas de tokens de tarjeta no están pensadas para procesos masivos.

Errores comunes: los fallos vuelven como HTTP 4xx o 5xx con resultCode, message y classDescription. Rejected_Unauthenticated significa una clave o un entorno incorrectos; Rejected_AccessDenied (o 403) significa que a la application le falta el rol para esa llamada; Invalid_BadRequest apunta a un parámetro. 404 suele indicar que NOON_PAYMENTS_API_URL lleva una ruta, o que el pedido no existe en este entorno. 429 significa limitación: la IA espera antes de reintentar y no repite la misma solicitud fallida, porque noon puede bloquear el pedido o vetar la dirección.

El conector no inicia pagos, no autoriza, revierte ni cancela pedidos y no gestiona la revisión antifraude.

Requisitos previos: NOON_PAYMENTS_API_URL, NOON_PAYMENTS_AUTH_KEY

Instalar el conector localmente

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 noon payments e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿En qué estado está el pedido de noon payments de nuestro pedido 100245, y cuánto se ha capturado y reembolsado?"
• "¿Se capturó por completo el pedido 3108459210, o aún queda un monto pendiente?"
• "Trae el reporte ReconciliationSettlement de ayer de noon payments y dame el enlace de descarga."
• "Consulta esta suscripción y dime su estado, monto y calendario."
• "Reembolsa 75 AED de la captura del pedido 3108459210. Muéstrame antes el pedido y el monto."

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT