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. 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ó.
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
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.
^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.estado/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": { "externalReferenceId": "string" } }'{ "data": { "encontrado": true, "apiStatus": "string", "transactionId": "string", "detalle": { "property1": null, "property2": null }, "preparacion": { "preparacionId": "string", "tipo": "pago", "estado": "preparada", "actualizadaEn": "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 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.
Validar y preparar pago Global66 POST
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.