Obtener transacción

curl --request GET \
  --url http://api.gu1.ai/transactions/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://api.gu1.ai/transactions/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://api.gu1.ai/transactions/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://api.gu1.ai/transactions/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("http://api.gu1.ai/transactions/{id}")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "transaction": {},
  "persisted": {},
  "baseCurrency": "<string>"
}

GET

transactions

{id}

Obtener transacción

curl --request GET \
  --url http://api.gu1.ai/transactions/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://api.gu1.ai/transactions/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://api.gu1.ai/transactions/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://api.gu1.ai/transactions/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("http://api.gu1.ai/transactions/{id}")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "transaction": {},
  "persisted": {},
  "baseCurrency": "<string>"
}

Resumen

Devuelve una transacción de tu organización. La respuesta usa objetos anidados origin y destination (con datos de entidad resueltos cuando existen). Esto difiere de Crear transacción, donde el cuerpo usa originDetails / destinationDetails más planos. En la lectura no se vuelve a ejecutar el motor de reglas. Por defecto la respuesta no incluye rulesExecutionSummary. Enviá includeRulesSummary=full para adjuntar el último resumen persistido en el objeto persisted (misma forma que Resumen de ejecución de reglas).

Endpoints

Método	Endpoint	Cuándo usarlo
Por ID	`GET /transactions/{id}`	Tienes el UUID de la transacción en gu1
Por external ID	`GET /transactions/external/{externalId}`	Solo tienes tu `externalId` del alta

Ambos devuelven la misma forma: { "transaction": { ... }, "persisted": { ... }, "baseCurrency": "..." }.

Parámetros de consulta

string

Opcional. Si se omite, el comportamiento es el de siempre (sin resumen de reglas en la lectura).

full — Carga la fila más reciente de risk_analysis_audits para esta transacción y agrega persisted.rulesExecutionSummary (rulesHit, rulesNoHit, actionsExecuted, scores, etc.). No re-ejecuta reglas. Pensado para detalle de una sola transacción / debugging; omitilo en polling masivo.

Por ID

GET http://api.gu1.ai/transactions/{id}

string

required

UUID de la transacción en gu1 (el mismo que transaction.id al crear).

Por external ID

GET http://api.gu1.ai/transactions/external/{externalId}

string

required

El externalId que enviaste al crear la transacción.

Autenticación

Requiere API key válida y permiso de lectura de transacciones (transactions:read):

Authorization: Bearer YOUR_API_KEY

La transacción debe pertenecer a la organización de la clave; si no, la API responde 404.

Respuesta (200 OK)

object

Registro completo de la transacción.

id (string) — UUID en gu1
externalId (string) — tu identificador externo
type, status — enums (misma semántica que en crear)
amount (number), currency (string)
amountInUsd (number | null)
currenciesExchange (array) — entradas { currency, exchangeRate, value }
paymentMethod (string | null)
origin (object) — entityId, externalId, name, country, type (person | company | null), taxId, riskScore, details (objeto; incluye lo que guardaste, p. ej. payment details)
destination (object) — misma estructura que origin
riskScore (number | null)
lastRiskEvaluationAt (string | null) — ISO del último audit de análisis de riesgo (presente en GET por UUID; no se incluye al consultar por external ID)
riskFactors (array)
activeMatchesCount, shadowMatchesCount (number, opcional)
hitRuleExternalIds (string[], opcional)
flagged (boolean)
locationDetails, deviceDetails (object)
channel (string | null), timeZone (string | null) — zona IANA si se envió al crear
description, category, metadata (object)
transactedAt, createdAt, updatedAt (ISO)
exchangeRate, rateSource, rateTimestamp, convertedAt — metadatos de conversión si aplica

object

Snapshot plano en camelCase de la fila en transactions (mismos nombres que create / input del motor): montos, contrapartes, metadata, riskFactors, etc.Con includeRulesSummary=full, puede incluir también:

rulesExecutionSummary (object) — última corrida persistida de reglas para esta transacción (no es re-evaluación en vivo). Se omite si no hay auditoría o si no se envía el query param.

string

Moneda base de la organización (código ISO, p. ej. USD).

Ejemplo (por ID, con resumen de reglas)

curl -s 'http://api.gu1.ai/transactions/550e8400-e29b-41d4-a716-446655440000?includeRulesSummary=full' \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "transaction": { "...": "..." },
  "persisted": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "externalId": "txn_12345",
    "amount": 150.5,
    "currency": "USD",
    "riskFactors": {},
    "metadata": {},
    "rulesExecutionSummary": {
      "rulesHit": [],
      "rulesNoHit": [],
      "totalScore": 0,
      "actionsExecuted": {}
    }
  },
  "baseCurrency": "USD"
}

Ejemplo (por ID, default)

curl -s http://api.gu1.ai/transactions/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "transaction": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "externalId": "txn_12345",
    "type": "PAYMENT",
    "status": "CREATED",
    "amount": 150.5,
    "currency": "USD",
    "amountInUsd": 150.5,
    "currenciesExchange": [],
    "paymentMethod": "CARD",
    "origin": {
      "entityId": "…",
      "externalId": "customer_001",
      "name": "Jane Doe",
      "country": "US",
      "type": "person",
      "taxId": null,
      "riskScore": 12.5,
      "details": {}
    },
    "destination": {
      "entityId": "…",
      "externalId": "merchant_456",
      "name": "Acme Store",
      "country": "US",
      "type": "company",
      "taxId": null,
      "riskScore": 8,
      "details": {}
    },
    "riskScore": 15,
    "lastRiskEvaluationAt": "2025-01-15T10:00:00.000Z",
    "riskFactors": [],
    "flagged": false,
    "locationDetails": {},
    "deviceDetails": {},
    "channel": "web_browser",
    "description": "Compra online",
    "category": "retail",
    "metadata": {},
    "transactedAt": "2025-01-15T09:55:00.000Z",
    "createdAt": "2025-01-15T09:55:01.000Z",
    "updatedAt": "2025-01-15T09:55:01.000Z",
    "exchangeRate": null,
    "rateSource": null,
    "rateTimestamp": null,
    "convertedAt": null
  },
  "baseCurrency": "USD"
}

Errores

400 — Query inválido

{
  "error": "Invalid query parameters",
  "details": []
}

Cuando includeRulesSummary no es full.

404 — No encontrada

{
  "error": "Transaction not found"
}

500 — Error del servidor

{
  "error": "Failed to fetch transaction",
  "details": "…"
}

​Resumen

​Endpoints

​Parámetros de consulta

​Por ID

​Por external ID

​Autenticación

​Respuesta (200 OK)

​Ejemplo (por ID, con resumen de reglas)

​Ejemplo (por ID, default)

​Errores

​400 — Query inválido

​404 — No encontrada

​500 — Error del servidor

​Ver también

Resumen

Endpoints

Parámetros de consulta

Por ID

Por external ID

Autenticación

Respuesta (200 OK)

Ejemplo (por ID, con resumen de reglas)

Ejemplo (por ID, default)

Errores

400 — Query inválido

404 — No encontrada

500 — Error del servidor

Ver también