Connect
API REST

Ejecutar pago Global66

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.

POST
/v1/tools/global66.pago.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.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  }}

Ejecutar pago RaaS Global66 POST

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.

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ó.