Connect
API REST

Validar y preparar pago Global66

Valida un pago contra Global66 sin ejecutarlo. Si es válido, deja una preparación de 15 minutos ligada a esta conexión y a quien valida, con su externalReferenceId ya reservado, y devuelve el preparacionId que exige global66.pago.ejecutar (o global66.pago_raas.ejecutar con raas:true). Solo la misma persona o agente puede ejecutarla, y solo con este mismo pago. No mueve dinero.

POST
/v1/tools/global66.pago.validar/execute

Authorization

AuthorizationBearer <token>

API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.

In: header

Header Parameters

X-Connect-Connection*string

Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.

Match^conn_

Request Body

application/json

La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/tools/global66.pago.validar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {      "pago": {        "transactionType": "REMITTANCE",        "cuentaOrigenId": "string",        "amount": 0,        "way": "ORIGIN",        "paymentType": "WIRE_TRANSFER",        "purposeCode": [          {            "purposeCode": -9007199254740991          }        ],        "beneficiary": {          "operationType": "BANK_TRANSFER",          "destinationCurrency": "string",          "beneficiaryName": "string",          "typeBeneficiary": "INDIVIDUAL",          "countryCode": "string",          "accountType": "SAVING",          "accountNumber": "string",          "documentNumber": "string",          "documentType": "string"        }      }    }  }'
{  "data": {    "valido": true,    "violaciones": [      {        "source": "string",        "field": "string",        "rule": "string",        "severity": "string",        "message": "string"      }    ],    "resumen": {      "cuentaOrigenId": "string",      "monedaOrigen": "string",      "transactionType": "string",      "monto": 0,      "way": "string",      "monedaDestino": "string",      "beneficiario": "string"    },    "preparacionId": "string",    "externalReferenceId": "string",    "expiraEn": "string"  },  "meta": {    "request_id": "string",    "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f",    "tool_id": "string",    "plane": "action",    "latency_ms": 0,    "audit_status": "recorded",    "idempotency": "replayed"  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}

Consultar estado de pago Global66 POST

Consulta en Global66 el estado de un pago originado por la API, por su externalReferenceId, junto con el desenlace que Connect anotó al ejecutarlo. 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ó.

Listar propósitos de operación Global66 POST

Propósitos válidos para preparar una operación MCP; usa el id real.