Modelos de fondeo

Cada dispersión sale de dinero que ya está puesto. Tu cuenta usa uno de tres modelos (o el prefondeo con tasa por ticket, más abajo), y GET /v1/tenant/capabilities te dice cuál (funding.model).

	Prefondeado	Cierre diario	Cuenta propia
funding.model	prefunded	daily_settlement	own_account
Cuándo pones el dinero	Antes de dispersar	Al cierre del día siguiente	Antes: cambias dólares en tu cuenta
Dónde está	En nuestra custodia, a tu nombre	Lo adelantamos nosotros (una línea)	En tu propia cuenta en la red de pago
Si falta	422 insufficient_tenant_funds	422 credit_limit_exceeded, sólo si tu línea tiene techo	El pago se rechaza: manda tu saldo real
La cifra que vigilas	prefundingBalance en GET /v1/treasury/position	creditDrawn en GET /v1/treasury/position	GET /v1/treasury/inventory
La tasa de tus cotizaciones	La de la plataforma	La de la plataforma	Tu tasa de venta del día
Qué cobramos	Una comisión por pago	Una comisión por pago	Un fee semanal sobre lo vendido

Prefondeado

Nos transfieres bolívares y quedan a tu nombre. Cada dispersión los descuenta en el momento; si no alcanzan, la dispersión no sale (insufficient_tenant_funds, con meta.required y meta.available). El fondeo lo registramos nosotros cuando vemos tu transferencia: la API no deja que una key se fondee a sí misma.

Cierre diario

Dispersas contra una línea: el dinero lo ponemos nosotros y tú liquidas al día siguiente lo que salió. creditDrawn es lo que nos debes ahora. Si tu línea tiene techo (funding.creditLimit), al pasarlo la dispersión responde credit_limit_exceeded. Ver Liquidación y cierre diario.

Cuenta propia

Tu dinero está en tu cuenta en la red de pago, no en la nuestra. Lo que decide si un pago sale es tu saldo real en esa cuenta. Tus cotizaciones usan tu tasa de venta del día (sellRates[].isToday te avisa si la fijaste otro día). Ver Vender dólares con tu tasa.

Prefondeo con tasa por ticket

funding.model: rate_locked_prefunding. Prefondeas en USDT y cada carga es un ticket con su tasa amarrada 30 minutos. Antes, registras las wallets desde las que vas a mandar (POST /v1/prefondeos/wallets-origen): sólo se acredita el USDT que sale de una de tus wallets de origen activas, de autocustodia y nunca de un exchange; nuestro equipo aprueba cada alta. Luego cotizas (POST /v1/prefondeos), mandas los USDT desde esa wallet a la wallet del ticket, avisas con el hash y nuestro equipo (dos personas) carga los Bs. Tus dispersiones gastan los tickets del más viejo al más nuevo, sin comisión por pago (va en la tasa). La cifra que vigilas: el saldoBs de tus tickets en GET /v1/prefondeos. La wallet del ticket sólo la ves con tu key sk_live_.

En tu cuenta de pruebas no hay wallet: tu prefondeo ya viene cargado. Al recibir tu key de pruebas tienes un ticket con 38.000,00 Bs simulados (1.000 USDT a 38,00) en GET /v1/prefondeos; cotiza payout_bs y dispersa. No mandes USDT en pruebas. A los 30 días su saldo se cierra a cero (prefondeo.vencido con simulado: true).

No convive con el cierre diario: para activarlo, tu línea de crédito tiene que estar apagada y sin deuda, y tu prefondeo sin tasa en 0. Lo coordinamos contigo antes de activarlo; mientras el modelo esté activo, la línea no se vuelve a encender.

En la cuenta de pruebas

Tu cuenta de pruebas (environment: sandbox) tiene el mismo modelo que tendrá la real, con dinero simulado: POST /v1/test-helpers/seed deja 1.000.000,00 Bs simulados si es prefondeada, o una tasa de venta de ejemplo si es cuenta propia. Con prefondeo por ticket, tu prefondeo de pruebas ya viene cargado (sin wallet).

Con cuenta propia, seed además deja 1.000.000,00 Bs en tu inventario si está en cero, y POST /v1/test-helpers/fundings anota más cambios de USD a Bs. Los pagos responden submitted y se liquidan solos en unos 20 s, con la comisión de la red de pago y el tope de USD 500 por operación, como en producción. Ver Entorno de pruebas.

Ojo con una key sk_test_ de tu cuenta real: no sale a ningún beneficiario real, pero comparte la contabilidad de tu cuenta, así que gasta tu prefondeo o gira tu línea como una live. Para probar, usa la cuenta de pruebas.