# 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.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ----------------------------------------------------------------- |
| **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`](/docs/referencia/conexiones/estado-consultar).
## Qué hace [#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 [#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
```json
{
"$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 [#salida]
| Campo | Tipo | Requerido | Descripción | |
| --------------------------- | ---------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `encontrado` | booleano | sí | False si Global66 no conoce la referencia (404). | |
| `apiStatus` | string | null | sí | PENDING, PROCESSING, COMPLETED o FAILED; COMPLETED no confirma la llegada del dinero. |
| `transactionId` | string | null | sí | ID de transacción, como texto. |
| `detalle` | objeto | null | sí | Detalle cuando Global66 lo entrega (solo COMPLETED). |
| `preparacion` | objeto | null | sí | Desenlace anotado por Connect; null si la referencia no es de esta conexión. |
| `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
```json
{
"$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 [#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](/docs/referencia/errores).