Obtener estado de transacción

Recupere el estado más reciente de una transacción específica mediante su id interno usando su clave API.

Solicitud

GET /api/v1/transactions/{transaction_id}?env=prod
Headers:
  x-api-key: <your_api_key>

{transaction_id} es el id (UUID) interno de la transacción, pasado como segmento de ruta.

Campos de respuesta

Campo	Descripción
amount	Importe en unidades menores
amount_with_fee	Importe incluida la tarifa (unidades menores)
amount_dest	Importe de destino de la conversión (unidades menores), si procede
currency	Código de moneda (por ejemplo, USDT)
currency_dest	Moneda de destino para la conversión, si corresponde
description	Descripción original proporcionada
env	prod (predeterminado). Conserve este valor al abrir y confirmar la solicitud.
error_description	Detalles del error si se rechaza el estado
finished	Finalizar marca de tiempo (ISO) si terminal
id	Identificador de transacción interna (UUID)
route	Ruta de procesamiento utilizada
started	Marca de tiempo de inicio (ISO)
status	Estado actual (consulte Estado del ciclo de vida en Convenciones de campo; por ejemplo, creado, cobrando, cobrado, reembolsado, rechazado, fallido)
txid	Identificador externo proporcionado por el cliente
type	Tipo de transacción (pago o desembolso)
widget_url	Enlace del widget (si el widget fluye)
simple_auth_redirect_url	3DS / autenticación adicional URL cuando corresponda

Ejemplo

curl --location 'https://app.heth.me/api/v1/transactions/c033ceaa-3726-4479-8be3-c9af8a0b2336?env=prod' \
  --header "x-api-key: $HETH_API_KEY"

Notas de uso

• Encuesta con retroceso exponencial (por ejemplo, 1, 2, 4, 8) hasta un estado terminal.
• Determinar el resultado de status; un finished ausente o presente por sí solo no es prueba del resultado.
• txid debe ser idempotente por operación comercial.

Recuperar mediante identificador de operación externa

curl --get 'https://app.heth.me/api/v1/transactions/example-order-001' \
  --header "x-api-key: $HETH_API_KEY" \
  --data-urlencode 'by=txid' \
  --data-urlencode 'env=prod'