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"
}
'

import requests

url = "https://your-app-domain.com/payments/verify"

payload = {
    "amount": 15000,
    "currency": "CLP",
    "description": "Pedido #12345 - Restaurante XYZ",
    "transactionId": "txn_abc123def456",
    "orderId": "order_xyz789",
    "externalUserId": "user_12345"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: 15000,
    currency: 'CLP',
    description: 'Pedido #12345 - Restaurante XYZ',
    transactionId: 'txn_abc123def456',
    orderId: 'order_xyz789',
    externalUserId: 'user_12345'
  })
};

fetch('https://your-app-domain.com/payments/verify', 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 => "https://your-app-domain.com/payments/verify",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => 15000,
    'currency' => 'CLP',
    'description' => 'Pedido #12345 - Restaurante XYZ',
    'transactionId' => 'txn_abc123def456',
    'orderId' => 'order_xyz789',
    'externalUserId' => 'user_12345'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://your-app-domain.com/payments/verify"

	payload := strings.NewReader("{\n  \"amount\": 15000,\n  \"currency\": \"CLP\",\n  \"description\": \"Pedido #12345 - Restaurante XYZ\",\n  \"transactionId\": \"txn_abc123def456\",\n  \"orderId\": \"order_xyz789\",\n  \"externalUserId\": \"user_12345\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://your-app-domain.com/payments/verify")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 15000,\n  \"currency\": \"CLP\",\n  \"description\": \"Pedido #12345 - Restaurante XYZ\",\n  \"transactionId\": \"txn_abc123def456\",\n  \"orderId\": \"order_xyz789\",\n  \"externalUserId\": \"user_12345\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://your-app-domain.com/payments/verify")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": 15000,\n  \"currency\": \"CLP\",\n  \"description\": \"Pedido #12345 - Restaurante XYZ\",\n  \"transactionId\": \"txn_abc123def456\",\n  \"orderId\": \"order_xyz789\",\n  \"externalUserId\": \"user_12345\"\n}"

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

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

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"
}
'

import requests

url = "https://your-app-domain.com/payments/verify"

payload = {
    "amount": 15000,
    "currency": "CLP",
    "description": "Pedido #12345 - Restaurante XYZ",
    "transactionId": "txn_abc123def456",
    "orderId": "order_xyz789",
    "externalUserId": "user_12345"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: 15000,
    currency: 'CLP',
    description: 'Pedido #12345 - Restaurante XYZ',
    transactionId: 'txn_abc123def456',
    orderId: 'order_xyz789',
    externalUserId: 'user_12345'
  })
};

fetch('https://your-app-domain.com/payments/verify', 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 => "https://your-app-domain.com/payments/verify",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => 15000,
    'currency' => 'CLP',
    'description' => 'Pedido #12345 - Restaurante XYZ',
    'transactionId' => 'txn_abc123def456',
    'orderId' => 'order_xyz789',
    'externalUserId' => 'user_12345'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://your-app-domain.com/payments/verify"

	payload := strings.NewReader("{\n  \"amount\": 15000,\n  \"currency\": \"CLP\",\n  \"description\": \"Pedido #12345 - Restaurante XYZ\",\n  \"transactionId\": \"txn_abc123def456\",\n  \"orderId\": \"order_xyz789\",\n  \"externalUserId\": \"user_12345\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://your-app-domain.com/payments/verify")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": 15000,\n  \"currency\": \"CLP\",\n  \"description\": \"Pedido #12345 - Restaurante XYZ\",\n  \"transactionId\": \"txn_abc123def456\",\n  \"orderId\": \"order_xyz789\",\n  \"externalUserId\": \"user_12345\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://your-app-domain.com/payments/verify")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": 15000,\n  \"currency\": \"CLP\",\n  \"description\": \"Pedido #12345 - Restaurante XYZ\",\n  \"transactionId\": \"txn_abc123def456\",\n  \"orderId\": \"order_xyz789\",\n  \"externalUserId\": \"user_12345\"\n}"

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

{
  "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

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.

string

required

Estado de la verificación. Valores posibles: approved, rejected, pending.

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"

​Cuerpo de la solicitud

​Ejemplo de solicitud

​Respuesta exitosa

​Ejemplo de respuesta exitosa

​Respuesta de rechazo

​Códigos de estado

​Notas importantes

Authorizations

Body

Response

Cuerpo de la solicitud

Ejemplo de solicitud

Respuesta exitosa

Ejemplo de respuesta exitosa

Respuesta de rechazo

Códigos de estado

Notas importantes