DocsRecursos da APIGestão de Carteiras, Saldos & Entradas
Recurso Contabilístico

Gestão de Carteiras, Saldos & Entradas

Aceda aos saldos posted da sua organização, compreenda o ciclo de crédito após cada cobrança e audite os movimentos de débito e crédito no posted ledger.

Como o Valor de Cada Cobrança Cai na Carteira

Cada transação liquidada (via Checkout, API, Links de Pagamento ou Faturas) é registada no ledger como valor pendente de aprovação; após o prazo de reserva passa a disponível:

1. Cobrança ao Cliente

1.500,00 MT

Valor pago pelo cliente via canal/gateway autorizado.

2. Tarifa EDPay (6%)

- 90,00 MT

Tarifa única transparente, sem custos ocultos adicionais.

3. Crédito na Carteira3. Valor líquido reservado

+ 1.410,00 MT

Lançado em reserved_minor (141.000 centavos). Libertação após 7 dias úteis.

4. Saque Bancário

2 a 7 dias úteis

2 a 7 dias úteis após aprovação do pedido.

• Unidades Menores (Minor Units): Para evitar arredondamentos de ponto flutuante, todos os valores contabilísticos são devolvidos em unidades menores de Meticais (centavos). 141000 corresponde exatamente a 1.410,00 MT.

• Imutabilidade Contabilística: Não existem saldos editáveis manualmente. Todo o saldo resulta da soma das entradas registadas em /v1/wallets/{id}/entries.

1. Listar Carteiras da Organização

Devolve a lista de todas as carteiras segregadas criadas para a sua organização no ambiente autenticado:

GET
/v1/wallets
cURL
curl -X GET "https://api-pay.edutecka.com/v1/wallets" \ -H "X-EDPay-Public-Key: <PUBLIC_KEY>" \ -H "X-EDPay-Private-Key: <PRIVATE_KEY>" \ -H "Accept: application/json"

2. Consultar Saldo em Tempo Real

Obtenha os três saldos ledger-backed: disponível (available_minor), pendente de aprovação (reserved_minor) e pendente para saque (pending_withdrawal_minor):

GET
/v1/wallets/{id}/balance
cURL
curl -X GET "https://api-pay.edutecka.com/v1/wallets/wal_mzn_main/balance" \ -H "X-EDPay-Public-Key: <PUBLIC_KEY>" \ -H "X-EDPay-Private-Key: <PRIVATE_KEY>" \ -H "Accept: application/json"

3. Extrato de Movimentos (Posted Ledger Entries)

Consulte cada lançamento individual na carteira com paginação por cursor:

GET
/v1/wallets/{id}/entries
cURL
curl -X GET "https://api-pay.edutecka.com/v1/wallets/wal_mzn_main/entries?limit=10" \ -H "X-EDPay-Public-Key: <PUBLIC_KEY>" \ -H "X-EDPay-Private-Key: <PRIVATE_KEY>" \ -H "Accept: application/json"

Política de Saques & Liquidação Bancária (2 a 7 Dias Úteis)

• Janela Regulatória de Liquidação: Em cumprimento com a legislação moçambicana (Lei n.º 11/2019 e Avisos do Banco de Moçambique), todos os saques solicitados para contas bancárias nacionais são processados entre 2 a 7 dias úteis após a captura da transação.

• Prevenção de Fraude & Chargebacks: O prazo mínimo de 2 dias úteis assegura o encerramento do ciclo de compensação interbancária e a validação de disputas legítimas com os clientes, garantindo a solidez dos fundos transferidos para a sua empresa.