curl --request GET \
--url https://hg.cash/api/v1/ve/transactions/{id}/status \
--header 'Authorization: Bearer <token>'import requests
url = "https://hg.cash/api/v1/ve/transactions/{id}/status"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://hg.cash/api/v1/ve/transactions/{id}/status', 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://hg.cash/api/v1/ve/transactions/{id}/status",
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 := "https://hg.cash/api/v1/ve/transactions/{id}/status"
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))
}HttpResponse<String> response = Unirest.get("https://hg.cash/api/v1/ve/transactions/{id}/status")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://hg.cash/api/v1/ve/transactions/{id}/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "550e8400-e29b-41d4-a716-446655440000",
"externalID": "1000",
"status": "pending",
"direction": "Inbound",
"amount": "100.5",
"currency": "USDT",
"orden_id": 1000,
"banco": "ONRAMP_BANK_NAME",
"numero_cuenta": "00000000000000000000"
}Obtener estado de la transacción (Venezuela)
Lee el estado de entrada o de salida. amount es una cadena decimal USDT. status incluye pending_kyc.
Campos opcionales, solo cuando están presentes: orden_id, montoFiat, tasaCompra, banco y numero_cuenta solo de entrada,
kyc_url de salida, y kyc_expires_at mientras la retención pending_kyc sigue abierta.
En un payout cancelado porque se requería verificación de identidad, kyc_url se incluye solo cuando se guardó una URL no vacía.
cancelledReason se incluye solo para KOLLAT_KYC_EXPIRED, KOLLAT_KYC_DECLINED o KOLLAT_KYC_REQUIRED.
Los demás motivos de cancelación se omiten.
El webhook status_change del comercio incluye cancelledReason solo para esos mismos tres códigos.
Una transacción que no es un movimiento de Venezuela devuelve 400.
curl --request GET \
--url https://hg.cash/api/v1/ve/transactions/{id}/status \
--header 'Authorization: Bearer <token>'import requests
url = "https://hg.cash/api/v1/ve/transactions/{id}/status"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://hg.cash/api/v1/ve/transactions/{id}/status', 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://hg.cash/api/v1/ve/transactions/{id}/status",
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 := "https://hg.cash/api/v1/ve/transactions/{id}/status"
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))
}HttpResponse<String> response = Unirest.get("https://hg.cash/api/v1/ve/transactions/{id}/status")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://hg.cash/api/v1/ve/transactions/{id}/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "550e8400-e29b-41d4-a716-446655440000",
"externalID": "1000",
"status": "pending",
"direction": "Inbound",
"amount": "100.5",
"currency": "USDT",
"orden_id": 1000,
"banco": "ONRAMP_BANK_NAME",
"numero_cuenta": "00000000000000000000"
}Autorizaciones
Token de autenticación de API de usuario con formato cash_<64-char-hex>. Valor de ejemplo cash_16cdc3b6f83c72d9d2680adca4f430962981f6bf32613a129dded0aa060387d2.
Parámetros de ruta
Respuesta
Estado de la transacción
Estado actual del libro. Incluye pending para el cash-in, processing cuando se acepta un payout, pending_kyc mientras la verificación de identidad retiene un payout, done y cancelled.
Inbound, Outbound Cadena decimal USDT positiva. No es un número JSON. Pueden aparecer hasta 8 dígitos fraccionarios. Los montos en VES no son este campo.
^\d+(\.\d+)?$"100.5"
"USDT"
Se incluye solo cuando está presente.
Metadato en VES. Se incluye solo cuando está presente.
Metadato en VES. Se incluye solo cuando está presente.
Banco de cobro, solo de entrada. Nunca se devuelve en un payout.
Número de cuenta de cobro, solo de entrada. Nunca se devuelve en un payout.
Solo de salida. Se incluye cuando se guardó una URL no vacía, también si un payout se canceló porque se requería verificación de identidad.
Se incluye mientras la retención pending_kyc sigue abierta.
Se incluye solo para KOLLAT_KYC_EXPIRED, KOLLAT_KYC_DECLINED o KOLLAT_KYC_REQUIRED. Los demás motivos de cancelación se omiten.
KOLLAT_KYC_EXPIRED, KOLLAT_KYC_DECLINED, KOLLAT_KYC_REQUIRED Desglose de comisión opcional en la respuesta de estado de una transacción directa. Los montos y las tasas son cadenas decimales. Se omite cuando la transacción no tiene desglose. collectedAmount es la comisión porcentual más la comisión fija. platformFee es el costo de billetera registrado y no se suma a collectedAmount. Incluye flatFee.source, que los webhooks de transacción omiten.
Show child attributes
Show child attributes

