Skip to main content
POST
/
payments
/
verify
Verificar transacción
curl --request POST \
  --url https://your-app-domain.com/payments/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 15000,
  "currency": "CLP",
  "description": "Pedido #12345 - Restaurante XYZ",
  "transactionId": "txn_abc123def456",
  "orderId": "order_xyz789",
  "externalUserId": "user_12345"
}'
{
  "transactionCode": "app_txn_987654",
  "status": "approved",
  "message": "Transacción verificada exitosamente"
}
Este endpoint permite a Justo verificar si una transacción puede ser procesada. Durante esta etapa se realizan validaciones internas como disponibilidad de fondos, autenticidad de la cuenta, límite diario, etc. Justo llamará a este endpoint antes de procesar el pago para asegurar que la transacción puede ser completada exitosamente.

​
Cuerpo de la solicitud

​
Ejemplo de solicitud

{
  "amount": 15000,
  "currency": "CLP",
  "description": "Pedido #12345 - Restaurante XYZ",
  "transactionId": "txn_abc123def456",
  "orderId": "order_xyz789",
  "externalUserId": "user_12345"
}

​
Respuesta exitosa

​
transactionCode
string
required
Código de transacción generado por la aplicación contenedora. Este código será usado posteriormente para verificar el estado de la transacción o para procesarla.
​
status
string
required
Estado de la verificación. Valores posibles: approved, rejected, pending.
​
message
string
Mensaje descriptivo sobre el resultado de la verificación (opcional).

​
Ejemplo de respuesta exitosa

{
  "transactionCode": "app_txn_987654",
  "status": "approved",
  "message": "Transacción verificada exitosamente"
}

​
Respuesta de rechazo

Si la verificación falla (por ejemplo, fondos insuficientes), se debe retornar: 
{
  "status": "rejected",
  "message": "Fondos insuficientes"
}

​
Códigos de estado

​
Notas importantes

Este endpoint debe validar internamente aspectos como:
  • Disponibilidad de fondos en la cuenta del usuario
  • Autenticidad de la cuenta
  • Límites diarios de transacciones
  • Restricciones de la cuenta
  • Cualquier otra validación requerida por la aplicación contenedora
El transactionCode retornado debe ser único y permitir identificar la transacción en pasos posteriores (procesamiento o verificación de estado).
En caso de requerir más datos para la verificación, esto puede configurarse coordinando con el equipo técnico de Justo.

Authorizations

​
Authorization
string
header
required

Propuesta de esquema de autenticación. Token de autenticación que debe ser coordinado entre Justo y la aplicación contenedora. El mecanismo específico debe acordarse entre ambos equipos técnicos.

Body

application/json

Propuesta de esquema de solicitud. Estructura propuesta para la verificación de pagos que Justo enviará a la aplicación contenedora.

​
amount
number
required

Monto de la transacción a verificar

Example:

15000

​
currency
string
required

Moneda de la transacción

Example:

"CLP"

​
description
string
required

Descripción del cargo que se realizará al usuario

Example:

"Pedido #12345 - Restaurante XYZ"

​
transactionId
string
required

Identificador único de la transacción generado por Justo

Example:

"txn_abc123def456"

​
orderId
string
required

Identificador del pedido asociado a esta transacción

Example:

"order_xyz789"

​
externalUserId
string
required

Identificador del usuario en la aplicación contenedora

Example:

"user_12345"

Response

La verificación fue procesada

Propuesta de esquema de respuesta. Estructura propuesta que la aplicación contenedora debe retornar a Justo después de verificar una transacción.

​
transactionCode
string
required

Código de transacción generado por la aplicación contenedora

Example:

"app_txn_987654"

​
status
enum<string>
required

Estado de la verificación

Available options:
approved,
rejected,
pending
Example:

"approved"

​
message
string

Mensaje descriptivo sobre el resultado de la verificación

Example:

"Transacción verificada exitosamente"