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.
externalID se omite hasta que existe el id de orden, y entonces se devuelve.
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.
feeBreakdown, cuando existe un desglose, omite flatFee.source.
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 VE_KYC_EXPIRED, VE_KYC_DECLINED o VE_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. Más de 8 dígitos fraccionarios se redondean hacia abajo a 8 y no se rechazan. Los montos en VES no son este campo.
^\d+(\.\d+)?$"100.5"
"USDT"
Se omite hasta que existe el id de orden. Se devuelve cuando ya es ese id de orden.
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 VE_KYC_EXPIRED, VE_KYC_DECLINED o VE_KYC_REQUIRED. Los demás motivos de cancelación se omiten.
VE_KYC_EXPIRED, VE_KYC_DECLINED, VE_KYC_REQUIRED Desglose de comisión opcional en el estado de Venezuela. Los montos y las tasas son cadenas decimales. Se omite cuando no hay desglose. flatFee incluye solo amount. Esta respuesta no incluye flatFee.source.
Show child attributes
Show child attributes

