Skip to main content
A Astron Pay mantém um ledger de partidas dobradas para todas as operações. Cada transação gera entries balanceados (débito + crédito) entre contas lógicas.

​
Tipos de conta

AccountTypeDescrição
RECEIVER_BRLSaldo em BRL do receiver
RECEIVER_CRYPTOSaldo em crypto do receiver
RECEIVER_BANKBanco real do receiver (origem do PIX de entrada)
MERCHANT_FEETaxas do merchant a liquidar
PLATFORM_FEETaxas da plataforma
PLATFORM_PIX_HOLDINGConta de custódia BRL da plataforma (PIX)
PLATFORM_CRYPTO_HOLDINGConta de custódia crypto da plataforma
PLATFORM_EQUITYEquity da plataforma (reservas em USDC)
PLATFORM_EQUITY_BRLEquity da plataforma em BRL
PLATFORM_OUTGOINGSaídas da plataforma (legado)
PLATFORM_SETTLEMENTLiquidações da plataforma (legado)
EXTERNALContrapartida externa — pagadores BRL/PIX não identificados
EXTERNAL_CRYPTOContrapartida on-chain — fonte de depósitos USDC inbound

​
Idempotência

Cada entry tem um idempotencyKey único baseado no contexto. Padrões:
FluxoChave
Payin — PIX recebidopayin:pix_received:{orderId}
Payin — taxa da plataformapayin:platform_fee:{orderId}
Payin — taxa do merchantpayin:merchant_fee:{orderId}
Payin — conversãopayin:conversion:{orderId}
Payin — transferência saídapayin:transfer_out:{orderId}
Payout — depósito cryptopayout:deposit:{orderId}
Payout — conversãopayout:conversion:{orderId}
Payout — taxa da plataformapayout:platform_fee:{orderId}
Payout — taxa do merchantpayout:merchant_fee:{orderId}
Payout — PIX enviadopayout:pix_out:{orderId}
Inserções duplicadas com a mesma key são no-ops — garante segurança em retentativas.

​
Liquidações (settlements)

Periodicamente (diário ou semanal, conforme acordo), as taxas acumuladas no MERCHANT_FEE são sacadas e enviadas via PIX para o merchant. Isso gera um registro Settlement.

​
Consulta

# Saldo acumulado de taxas
curl https://api.astronpay.co/api/v1/ledger/fees/balance \
  -H "x-api-key: $API_KEY" -H "x-api-secret: $API_SECRET"

# Histórico de liquidações
curl https://api.astronpay.co/api/v1/ledger/settlements \
  -H "x-api-key: $API_KEY" -H "x-api-secret: $API_SECRET"

# Saldo de um receiver específico
curl https://api.astronpay.co/api/v1/ledger/receivers/$RECEIVER_ID/balance \
  -H "x-api-key: $API_KEY" -H "x-api-secret: $API_SECRET"
Ver Consultando saldos para o fluxo completo.