Account
Una Account es una entidad financiera virtual dentro de la plataforma — el titular de saldo. Puede representar cualquier parte que necesite mantener saldo: el vendedor de un marketplace, un afiliado, o la propia cuenta de ingresos de la plataforma.
Una Account no es una billetera blockchain, no implica identidad legal verificada, y no es
lo mismo que un usuario humano del panel administrativo (eso es Member) — Account participa en
dinero, Member opera la Organization.
External ID
Una Account se referencia por un External ID — un identificador que defines para correlacionarla con tu propio sistema, sin necesidad de enviar datos personales. Único por Organization, no globalmente.
Balance
El saldo de una Account se compone de tres recortes del mismo registro contable:
- Disponible — puede moverse libremente.
- Pendiente — en confirmación (ej.: depósito esperando confirmaciones de red).
- Reservado — comprometido con una Transaction activa.
Toda transición entre estos tres componentes es un nuevo asiento contable, nunca una edición
directa de valor — ver Ledger. Un beneficiario de un Settlement/Payout tiene dos
recortes más además de estos tres — Payable (adeudado, aún no pagado) y Delivered (ya
pagado) — consultables vía getPayableSummary, nunca mezclados con Available (vea
Transaction, Settlement, Split y Refund).
Rutas
- Crear:
POST /v1/organizations/{organizationId}/accounts - Consultar:
GET /v1/accounts/{accountId} - Consultar saldo:
GET /v1/accounts/{accountId}/balance - Congelar / descongelar:
freeze-account/unfreeze-account