Construa um Marketplace com a Ishtaran

Alice quer um par de fones de ouvido sem fio que Bob está vendendo na Mercatto, um marketplace construído sobre a Ishtaran. Ela paga 200 USDT. Esse dinheiro não vai direto pro Bob — vai para uma caixa trancada com uma etiqueta: ainda não pode ser gasto. Só quando a Mercatto avisa a Ishtaran "os fones chegaram" é que a Ishtaran abre a caixa e divide o que está dentro: uma fatia pequena para a Mercatto, o resto para o Bob.

Números reais de uma execução real: 200 USDT entram, 1.80 de Platform Fee, 178.38 para Bob, 19.82 para a própria Account de comissão da Mercatto.

Por que isso existe

Isto não é um tutorial de marketing. Todo bloco de código destas páginas é o arquivo exato que a suíte E2E da Mercatto importa e executa — os mesmos arquivos que travam todo release de SDK e todo release da plataforma. Se uma mudança na Ishtaran quebrar essa história, o release é bloqueado. Se você está construindo um marketplace, deveria conseguir ler isto, copiar o código, rodar contra o Sandbox real, e ver as mesmas respostas reais mostradas aqui.

Nada aqui é inventado pra parecer mais bonito. Onde a plataforma tem uma limitação real — uma rota que ainda não existe, uma regra de autorização que nos surpreendeu, um cooldown que não pode ser pulado — isso é explicitado, nunca escondido. Veja Known limitations para a lista completa.

Os personagens

Quem	Papel	Como chegam até a Ishtaran
Mercatto	O marketplace — dona da Organization e da Application na Ishtaran	Sua própria Application API Key, e (para algumas operações — veja Architecture) uma sessão de Member
Alice	Compradora	Seu próprio login self-service de AccountHolder — a Mercatto nunca vê sua senha
Bob	Vendedor	Seu próprio login self-service de AccountHolder, igual ao de Alice
Account de receita da Mercatto	Onde a própria comissão do marketplace cai	Uma Account comum, de propriedade direta da Mercatto
Ishtaran	Infraestrutura financeira	Nunca decide se os fones realmente foram enviados — só a Mercatto sabe disso

Capítulos

1. Architecture — a sequência completa, toda chamada de método real
2. Setup — a Mercatto se cadastra
3. Seller onboarding — Bob, Alice e a própria Account de receita da Mercatto
4. Creating an order — Workflow + Transaction com um Split real
5. Accepting payment — o Payment Intent e o endereço de depósito
6. Holding funds — a reserva, e o que "trancado" realmente significa
7. Confirming delivery — o evento que não é um portão
8. Settlement and Split — Fee, Distributable Amount, o Split real
9. Partial Settlement — liberando fundos em parcelas
10. Seller balance — como Bob descobre que recebeu
11. Withdrawal — e o cooldown real que o bloqueia
12. Failure scenarios — 11 caminhos alternativos reais, todos testados ao vivo
13. Full source — cada arquivo, em uma página
14. Known limitations — lacunas reais, nunca escondidas
15. Run it yourself — contra o Sandbox público real, sem precisar de acesso privado