• ERROR
  • ACCIÓN
  • DATOS
  • HUMANO

Cómo depurar fallos de pago con tu IA y Checkout.com

Conecta Checkout.com a tu cliente de IA una sola vez. Después, tu agente se encargará de analizar los registros de transacciones para hallar la causa raíz de los rechazos.

Pregunta a la IA sobre esta página

Respuesta rápida

¿Cómo puedo usar la IA para saber por qué falló un pago?

Tu IA utiliza las herramientas de Checkout.com para extraer códigos de error específicos y las acciones de pago necesarias para cualquier transacción. Así evitarás buscar manualmente en el panel de control y podrás ir directo al motivo del rechazo. Verás el desglose detallado del fallo a continuación.

Donde se centralizan los problemas.

Resultados de una sesión de depuración

Una vez que tu IA tiene acceso a los datos de la pasarela, clasifica cada fallo en una de estas cuatro categorías.

ERROR

Rechazos directos

La IA identifica códigos de error específicos de la pasarela. Obtendrás un motivo claro de por qué el banco o el procesador rechazó el cargo.

ACCIÓN

Pasos requeridos

La IA localiza pagos pendientes de acción. Te indicará si el usuario debe completar el 3D Secure u otra autenticación.

DATOS

Detalles de la transacción

La IA extrae los metadatos brutos del pago. Obtienes el estado exacto de la transacción sin salir de tu chat.

HUMANO

Intervención manual

La IA señala problemas que no puede resolver, como disputas por fraude o bloqueos de cuenta. Tú decides cómo gestionar estos casos.

El flujo

Lo que hace tu IA cuando ocurre un fallo.

En lugar de navegar por el panel de Checkout.com, tu agente realiza la recuperación de datos por ti.

  1. Obtener datos de la transacción

    Tu agente extrae los detalles específicos de un ID de transacción fallida para ver su estado actual.

    get_payment_details
  2. Identificar acciones necesarias

    La IA comprueba si el pago está retenido por falta de autenticación o pasos pendientes del usuario.

    get_payment_actions
  3. Extraer códigos de error

    El agente analiza la respuesta de la pasarela para encontrar el motivo exacto del rechazo.

    get_payment_details
  4. Resumir el fallo

    La IA combina el código de error y las acciones requeridas en una explicación clara y directa.

    get_payment_detailsget_payment_actions

Pruébalo

Copia estos ejemplos para empezar.

Usa estos prompts para iniciar una sesión de depuración con tu agente.

Puntos de partida

Estos son solo ejemplos. Necesitarás proporcionar un ID de pago o una referencia de transacción específica de tu cuenta de Checkout.com.

Checkout.com Connector

Todo listo. Elige tu cliente MCP y sigue las instrucciones de configuración.

Enlace del conectorhttps://edge.vinkius.com/vk_preview_S3lDg6SN1hdkNWm91f9wcNYP96cnMkScbk1F3NW4/mcp

Claude Desktop

Sigue los pasos siguientes para conectarte en segundos.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Checkout.com capabilities are ready to use.
Configuración · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "checkoutcom-1-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_S3lDg6SN1hdkNWm91f9wcNYP96cnMkScbk1F3NW4/mcp"
    }
  }
}
Copia en el chat04
  • ¿Por qué falló el pago con ID 'ch_12345' en Checkout.com?

  • Revisa las acciones de pago para la transacción 'pay_98765' para ver si requiere 3D Secure.

  • Resume el código de error y el motivo del rechazo de este pago en Checkout.com: 'ch_abcde'.

  • Lista todas las acciones requeridas para la última transacción fallida en mi cuenta de Checkout.com.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Empieza aquí

Conecta Checkout.com una vez y empieza a preguntar.

Solo necesitas vincular tu cuenta una vez. Vinkius gestiona la conexión de forma segura y podrás preguntar a tu IA sobre tus transacciones de inmediato.

Conectar Checkout.com a tu IA

FAQ

Preguntas comunes

  • 01

    ¿Puede la IA reembolsar a un cliente?

    No. La IA solo puede leer detalles y acciones de pago. Debes procesar los reembolsos manualmente a través de tu pasarela o tus herramientas internas.

  • 02

    ¿Puede la IA arreglar una tarjeta rechazada?

    No. La IA identifica por qué se rechazó una tarjeta, pero no puede modificar los datos de la misma ni forzar que una transacción tenga éxito.

  • 03

    ¿La IA ve mis números de tarjeta de crédito completos?

    No. La IA solo accede a los datos proporcionados por la API de Checkout.com, que no incluyen números de tarjeta completos ni sin enmascarar.

  • 04

    ¿Puedo usar esto con Claude?

    Sí. Puedes usarlo con cualquier cliente compatible con MCP, como Claude, Cursor o Windsurf, una vez que hayas conectado el conector.

  • 05

    ¿Qué pasa si la IA no encuentra el código de error?

    La IA te informará que no puede encontrar los datos específicos. No inventará ni adivinará un motivo de error si la pasarela no lo ha proporcionado.

Conecta Checkout.com a Claude, Cursor, ChatGPT y más