Pular para o conteúdo principal

Account

Uma Account é uma entidade financeira virtual dentro da plataforma — o titular de saldo. Pode representar qualquer parte que precise deter saldo: o vendedor de um marketplace, um afiliado, ou a própria conta de receita da plataforma.

Uma Account não é uma carteira blockchain, não implica identidade legal verificada, e não é o mesmo que um usuário humano do painel administrativo (isso é Member) — Account participa de dinheiro, Member opera a Organization.

External ID​

Uma Account é referenciada por um External ID — um identificador que você define para correlacioná-la com seu próprio sistema, sem precisar enviar dados pessoais. Único por Organization, não globalmente.

Balance​

O saldo de uma Account é composto por três recortes do mesmo registro contábil:

  • Disponível — pode ser movimentado livremente.
  • Pendente — em confirmação (ex.: depósito aguardando confirmações de rede).
  • Reservado — comprometido com uma Transaction ativa.

Toda transição entre esses três componentes é um novo lançamento contábil, nunca uma edição direta de valor — ver Ledger. Um beneficiário de um Settlement/Payout tem mais dois recortes além desses três — Payable (devido, ainda não pago) e Delivered (já pago) — consultáveis via getPayableSummary, nunca misturados em Available (ver Transaction, Settlement, Split e Refund).

Rotas​