Consultar estado de pago Global66

Consulta en Global66 el estado de un pago originado por la API, por su externalReferenceId, junto con el desenlace que Connect anotó al ejecutarlo.


Tool ID	`global66.pago.estado`
Nombre MCP	`global66__pago__estado`
Conector	`global66`
Plano	`action`
Scope (permiso)	`global66:read`
Auth	`connection_credentials`
Versión	`1`
Sensible	no
Deprecado	no
Comportamiento	readOnly=true, destructive=false, idempotent=true, openWorld=true

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Qué hace

PENDING, PROCESSING o FAILED pueden venir sin detalle: no es un fallo de la consulta. encontrado:false no prueba que el pago no exista si la orden aún no se registró.

Entrada

Campo	Tipo	Requerido	Descripción
`externalReferenceId`	string `^cnx[0-9a-f]{32}$`	sí	Referencia devuelta por global66.pago.validar o global66.pago.ejecutar.

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "externalReferenceId": {
      "type": "string",
      "pattern": "^cnx[0-9a-f]{32}$",
      "description": "Referencia devuelta por global66.pago.validar o global66.pago.ejecutar."
    }
  },
  "required": [
    "externalReferenceId"
  ]
}

Salida

Campo	Tipo	Requerido	Descripción
`encontrado`	booleano	sí	False si Global66 no conoce la referencia (404).
`apiStatus`	string	null	sí
`transactionId`	string	null	sí
`detalle`	objeto	null	sí
`preparacion`	objeto	null	sí
`preparacion.preparacionId`	string	sí	Preparación de esta referencia.
`preparacion.tipo`	`"pago"` · `"raas"`	sí	Tool con que se ejecuta.
`preparacion.estado`	`"preparada"` · `"consumida"` · `"ejecutada"` · `"rechazada"` · `"incierta"`	sí	preparada: aún sin ejecutar. consumida: se inició la ejecución y no se anotó su fin. ejecutada: Global66 la recibió. rechazada: no se ejecutó. incierta: puede haberse ejecutado; reintenta con la misma clave o consulta de nuevo.
`preparacion.actualizadaEn`	string	sí	Instante ISO 8601 con Z del último cambio.

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "encontrado": {
      "type": "boolean",
      "description": "False si Global66 no conoce la referencia (404)."
    },
    "apiStatus": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "PENDING, PROCESSING, COMPLETED o FAILED; COMPLETED no confirma la llegada del dinero."
    },
    "transactionId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "ID de transacción, como texto."
    },
    "detalle": {
      "anyOf": [
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ],
      "description": "Detalle cuando Global66 lo entrega (solo COMPLETED)."
    },
    "preparacion": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "preparacionId": {
              "type": "string",
              "description": "Preparación de esta referencia."
            },
            "tipo": {
              "type": "string",
              "enum": [
                "pago",
                "raas"
              ],
              "description": "Tool con que se ejecuta."
            },
            "estado": {
              "type": "string",
              "enum": [
                "preparada",
                "consumida",
                "ejecutada",
                "rechazada",
                "incierta"
              ],
              "description": "preparada: aún sin ejecutar. consumida: se inició la ejecución y no se anotó su fin. ejecutada: Global66 la recibió. rechazada: no se ejecutó. incierta: puede haberse ejecutado; reintenta con la misma clave o consulta de nuevo."
            },
            "actualizadaEn": {
              "type": "string",
              "description": "Instante ISO 8601 con Z del último cambio."
            }
          },
          "required": [
            "preparacionId",
            "tipo",
            "estado",
            "actualizadaEn"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Desenlace anotado por Connect; null si la referencia no es de esta conexión."
    }
  },
  "required": [
    "encontrado",
    "apiStatus",
    "transactionId",
    "detalle",
    "preparacion"
  ],
  "additionalProperties": false
}

Errores de esta tool

Código	HTTP	Reintentable	Qué hacer
`connection_disabled`	403	no	Reactívala en /connections o usa otra conexión del mismo sistema.
`connection_not_found`	404	no	Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
`connection_credential_required`	428	no	Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior.
`connection_busy`	409	sí	Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez.
`upstream_error`	502	sí	Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.
`timeout`	504	sí	Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo.

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.

Consultar estado de pago Global66

Qué hace

Entrada

Salida

Errores de esta tool

En esta página