Qué pagos salieron de un ticket

GET/prefondeos/{id}/consumosProbar

ServidorURL base

API key x-api-keyRecordar la clave en este navegador (localStorage, no sale de aquí)

Parámetros de rutaidstringobligatorio

La llamada la hace tu navegador, contra el servidor que elijas arriba. Si la documentación no está servida desde el mismo origen que la API, el navegador puede bloquear la respuesta por CORS: en ese caso abre estas páginas desde la propia API (/docs) o usa el curl de arriba.

GET

/prefondeos/{id}/consumos

const url = 'http://localhost:3000/v1/prefondeos/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/consumos';
const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url http://localhost:3000/v1/prefondeos/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/consumos \
  --header 'x-api-key: <x-api-key>'

Scope treasury:read. Cada tramo de pago que salió de este ticket, a su tasa y su costo en micro-USDT, y los reversos (pago fallido o devuelto) que lo regresaron.

Authorizations

ApiKeyAuth

Parameters

Path Parameters

required

string format: uuid

Responses

200

El ticket y sus tramos

application/json

object

prefondeo

Un ticket de prefondeo. Montos en minor units como texto: micro-USDT (6 decimales) y céntimos de Bs. Tasas en Bs por 1 USDT con 8 decimales.

object

string format: uuid

estado

cotizado → enviado (avisaste) → recibido (nuestro equipo lo vio en la red) → cargado (otra persona aprobó: tienes los Bs) → consumido (saldo en 0; vuelve a cargado si se revierte un pago). vencido si no avisaste a tiempo; rechazado si lo cancelaste o no llegó.

string

Allowed values: cotizado enviado recibido cargado consumido vencido rechazado

origen

pruebas: tu prefondeo de pruebas, ya cargado con Bs simulados (sin wallet)

string

Allowed values: cotizado manual excedente pruebas

red

Red donde se reciben los USDT

string

direccion

Wallet de recepción (la fija nuestro equipo). null en tu cuenta de pruebas o con una sk_test_

string

nullable

activo

string

Allowed values: USDT

usdtCotizado

string

bsCotizado

string

tasa

Tasa amarrada (con spread)

string

tasaMercado

string

nullable

spreadBps

integer

venceEn

string format: date-time

nullable

referencia

string

nullable

usdtEnviado

string

nullable

enviadoEn

string format: date-time

nullable

usdtRecibido

string

nullable

recibidoEn

string format: date-time

nullable

recibidoTarde

Llegó en la red después de venceEn; se cargó a la tasa de ese momento

boolean

tasaAplicada

La tasa con la que se cargaron los Bs

string

nullable

usdtCargado

string

nullable

bsCargado

string

nullable

usdtExcedente

USDT que llegaron de más (no se cargan en este ticket)

string

excedenteDestino

string

nullable

Allowed values: ticket_nuevo devuelto_fuera

saldoBs

Bs que le quedan al ticket

string

usdtConsumido

Costo en USDT de lo ya gastado

string

cargadoEn

string format: date-time

nullable

motivoRechazo

string

nullable

simulado

Cargado desde la cuenta de pruebas: no es dinero real

boolean

direccionOrigen

El from de la transferencia que anotó nuestro equipo (una de tus wallets de origen)

string

nullable

walletOrigenId

Tu wallet de origen registrada

string format: uuid

nullable

esperaWalletHasta

El USDT llegó desde una wallet sin registrar: el ticket espera hasta aquí (72 h, con su tasa) a que la registres y la aprobemos

string format: date-time

nullable

caducaEn

Sólo tu prefondeo de pruebas: a esta hora se cierra su saldo simulado (te llega prefondeo.vencido)

string format: date-time

nullable

creadoEn

string format: date-time

actualizadoEn

string format: date-time

consumos

Array<object>

object

paymentId

string format: uuid

tipo

string

Allowed values: consumo reverso

montoBs

string

costoUsdt

string

tasa

string

paymentStatus

submitted = la red de pago la aceptó y está liquidando. Es el estado HABITUAL justo después de dispersar, porque la red de pago de bolívares es asíncrona. No reintentar: se cierra por webhook.

unknown = la red de pago no confirmó y no sabemos si pagó. NO reintentar: se resuelve automáticamente y te notificamos por webhook.

string

Allowed values: created pending submitted unknown settled failed returned reversed

creadoEn

string format: date-time

Example

{
  "prefondeo": {
    "estado": "cotizado",
    "origen": "cotizado",
    "activo": "USDT",
    "excedenteDestino": "ticket_nuevo"
  },
  "consumos": [
    {
      "tipo": "consumo",
      "paymentStatus": "created"
    }
  ]
}