Um checkout de três vendedores, comissão de 4% e política de repasses revisada.
1. Prepare o projeto
Abra Projeto → Marketplace → Configurações. Ative e selecione as lojas. Mantenha repasses pausados. Faça backup das carteiras e ative Bitcoin ou métodos EVM compatíveis em cada loja.
O cliente paga primeiro nessas carteiras. Você controla as chaves e deve os saldos registrados aos vendedores. Separe moedas nativas livres para taxas. Sweeps comuns não gastam endereços Marketplace.
2. Adicione e aprove três vendedores
Em Vendedores, adicione cada vendedor e endereço Bitcoin mainnet. Confirme com ele por outro canal antes de aprovar. Para tokens EVM, ele também precisa de endereço aprovado naquela rede exata.
Defina a comissão do projeto em 4%. Ajustes de loja, vendedor e fatura autorizada são salvos; alterações depois não mudam uma divisão existente.
3. Crie a fatura compartilhada
Em Marketplace → Faturas, crie 300 USD com três partes brutas de 100 USD. A soma deve ser exata. Envie o link ao cliente.
Na API, use uma chave Marketplace separada e envie strings decimais para /v1/marketplace/invoices. Salve a chave de idempotência antes da chamada e reutilize após timeout. Exemplos de chamadas →
4. Revise e envie
Espere as divisões verificadas ficarem disponíveis. Na cotação fixada cada vendedor recebe 96 USD equivalentes e ficam 12 USD de comissão. Se a taxa de processamento for 1%, usa 3 USD de crédito pré-pago. Taxas de rede são separadas.
Em Repasses prepare divisões disponíveis e limite taxas nativas e gas. Bitcoin exige todas as partes não pagas de cada fatura no mesmo lote. Revise destinatários e plano exatos, aprove uma vez e acompanhe até Paid, não só Broadcast.
5. Ative a automação com cuidado
Em Configurações adicione política por ativo: mínimo, limites por repasse e dia, orçamentos nativos e gas, intervalo e confirmações. Ative só após revisar limites e destinos; depois retome os repasses.
Políticas automáticas enviam sem novos cliques. Crédito baixo ou bloqueio de transferências pausa gastos, mas monitoramento e contabilidade continuam.
6. Resolva exceções sem duplicar envios
- Pagamento a menor: a tolerância não cria saldos sem fundos. Espere mais pagamento, reembolse ou aprove uma divisão menor coberta.
- Sem gas: adicione moedas nativas livres à carteira e revise o repasse salvo. Não crie outro para contornar.
- Timeout de webhook: repita o mesmo evento assinado. Verifique assinatura bruta e projeto, salve event_id único e confirme. Fatura liquidada não significa repasse concluído.
- Reembolso após pagar vendedores: abasteça o endereço principal separadamente, confirme o endereço do cliente, prepare reembolso integral no mesmo ativo e aprove. Não há débito automático dos vendedores.
- Restauração ou transmissão incerta: mantenha repasses pausados e confira os hashes salvos antes de retomar. Timeout não prova que nada foi enviado.