Connect
API REST

Ejecutar pago RaaS Global66

Ejecuta una remesa, P2P o cambio con remitente final opcional (RaaS) desde una cuenta de la conexión. Requiere que Global66 haya habilitado RaaS para la empresa y el permiso global66:raas en la conexión. MUEVE DINERO. Exige el preparacionId de global66.pago.validar (con raas:true), el MISMO pago validado y una Idempotency-Key estable. Solo quien validó puede ejecutar. Un reintento con la misma clave reenvía la misma referencia y Global66 no duplica el pago. Ante un timeout, reintenta con la misma clave o consulta global66.pago.estado; nunca uses una clave nueva ni valides de nuevo el mismo pago.

POST
/v1/tools/global66.pago_raas.ejecutar/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_
Idempotency-Key*string

UUID v4 canónica generada por el caller para esta acción destructiva. Es obligatoria: el gateway no la autogenera. Reenvía exactamente la misma UUID para consultar o reconciliar el mismo intento; una UUID distinta identifica otra operación.

Match^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
Formatuuid

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_raas.ejecutar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Idempotency-Key: 9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743" \  -H "Content-Type: application/json" \  -d '{    "input": {      "preparacionId": "string",      "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": {    "estado": "aceptado",    "externalReferenceId": "string",    "preparacionId": "string",    "transactionId": "string",    "apiStatus": "string",    "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"    }  },  "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  }}

Preparar operación Global66 para aprobación POST

Deja una operación en Global66 PENDIENTE DE APROBACIÓN humana en la app de Global66 (PENDING_CONFIRMATION_MCP), a partir de una cotización. NO envía dinero: nadie puede aprobarla, cancelarla ni modificarla desde Connect. El quoteId es de un solo uso, así que repetirla no crea otra operación.

Ejecutar pago Global66 POST

Ejecuta una remesa, un P2P o un cambio de divisas desde una cuenta de la conexión. MUEVE DINERO. Exige el preparacionId de global66.pago.validar, el MISMO pago validado y una Idempotency-Key estable. Solo quien validó puede ejecutar. Un reintento con la misma clave reenvía la misma referencia y Global66 no duplica el pago. Ante un timeout, reintenta con la misma clave o consulta global66.pago.estado; nunca uses una clave nueva ni valides de nuevo el mismo pago.