Saltar al contenido principal
GET
/
v1
/
validations
/
{id}
Recuperar una Validacion de Transaccion
curl --request GET \
  --url https://tracer.lerian.io/v1/validations/{id} \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <api-key>'
{
  "validationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "subType": "<string>",
  "amount": "<string>",
  "currency": "<string>",
  "transactionTimestamp": "2023-11-07T05:31:56Z",
  "reason": "<string>",
  "account": {
    "accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "metadata": {}
  },
  "segment": {
    "segmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "metadata": {}
  },
  "portfolio": {
    "portfolioId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "metadata": {}
  },
  "merchant": {
    "merchantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "category": "<string>",
    "country": "<string>",
    "metadata": {}
  },
  "metadata": {},
  "matchedRuleIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "evaluatedRuleIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "limitUsageDetails": [
    {
      "limitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "limitAmount": "<string>",
      "currentUsage": "<string>",
      "exceeded": true,
      "scope": "<string>",
      "attemptedAmount": "<string>",
      "skipped": true
    }
  ],
  "processingTimeMs": 123,
  "totalRulesLoaded": 123,
  "truncated": true,
  "createdAt": "2023-11-07T05:31:56Z"
}

Autorizaciones

​
X-API-Key
string
header
requerido

API Key authentication. Used by single-tenant deployments (MULTI_TENANT_ENABLED=false). Sent on every /v1/* request.

Encabezados

​
Content-Type
string
requerido

El tipo de medio del recurso. Debe ser application/json.

​
X-API-Key
string
requerido

La clave API para autenticacion. Este encabezado es requerido para todos los endpoints excepto verificaciones de salud.

​
X-Request-Id
string<uuid>

Un identificador unico usado para rastrear y seguir cada solicitud.

Parámetros de ruta

​
id
string<uuid>
requerido

El identificador unico de la validacion de transaccion que desea recuperar.

Respuesta

Indica que la solicitud fue exitosa y la respuesta contiene los datos esperados.

Registro completo de validacion de transaccion.

​
validationId
string<uuid>

Identificador unico generado por el servidor para este registro de validacion.

​
requestId
string<uuid>

Identificador de solicitud proporcionado por el cliente para correlacion.

​
transactionType
enum<string>

Tipo de transaccion (metodo de pago).

Opciones disponibles:
CARD,
WIRE,
PIX,
CRYPTO
​
subType
string

Subtipo de transaccion para contexto adicional.

​
amount
string

Monto de la transacción como cadena decimal (ej., "1500.00").

​
currency
string

Codigo de moneda ISO 4217.

​
transactionTimestamp
string<date-time>

Cuando ocurrio la transaccion.

​
decision
enum<string>

Decision de validacion.

Opciones disponibles:
ALLOW,
DENY,
REVIEW
​
reason
string

Razon legible para humanos de la decision.

​
account
object

Contexto de cuenta para validacion.

​
segment
object

Contexto de segmento (opcional). Si se proporciona, segmentId es requerido.

​
portfolio
object

Contexto de portafolio (opcional). Si se proporciona, portfolioId es requerido.

​
merchant
object

Contexto de comerciante (opcional, recomendado para transacciones con tarjeta). Si se proporciona, merchantId es requerido.

​
metadata
object

Pares clave-valor personalizados proporcionados en la solicitud.

​
matchedRuleIds
string<uuid>[]

IDs de reglas que coincidieron y activaron la decision.

​
evaluatedRuleIds
string<uuid>[]

IDs de todas las reglas que fueron evaluadas.

​
limitUsageDetails
object[]

Detalles sobre cada limite verificado durante la validacion.

​
processingTimeMs
number<double>

Tiempo de procesamiento en milisegundos.

​
totalRulesLoaded
integer

Numero total de reglas cargadas para evaluacion.

​
truncated
boolean

Si la respuesta fue truncada debido a limites de tamano.

​
createdAt
string<date-time>

Cuando se creo el registro de validacion.