Saltar al contenido principal

Construye un Marketplace con Ishtaran

Alice quiere unos audífonos inalámbricos que Bob vende en Mercatto, un marketplace construido sobre Ishtaran. Ella paga 200 USDT. Ese dinero no va directo a Bob — entra en una caja bloqueada con una etiqueta: no se puede gastar todavía. Solo cuando Mercatto le dice a Ishtaran "los audífonos llegaron" es que Ishtaran abre la caja y divide lo que hay dentro: una pequeña parte para Mercatto, el resto para Bob.

Alicecompradorapaga 200 USDTReserved"no se puede gastar todavía"🔒Transaction: RESERVEDMercatto confirma la entrega ↓19.82Mercattocomisión del 10%178.38Bobvendedor1.80 (0.9%) se queda con Ishtaran como Platform Fee
Números reales de una ejecución real: entran 200 USDT, 1.80 de Platform Fee, 178.38 para Bob, 19.82 para la Account de comisión propia de Mercatto.

Por qué existe esto​

Esto no es un tutorial de marketing. Cada bloque de código en estas páginas es el archivo exacto que la suite E2E de Mercatto importa y ejecuta — los mismos archivos que bloquean cada release de SDK y cada release de la plataforma. Si un cambio en Ishtaran rompe esta historia, el release se bloquea. Si estás construyendo un marketplace, deberías poder leer esto, copiar el código, correrlo contra el Sandbox real, y ver las mismas respuestas reales que se muestran aquí.

Nada aquí está inventado para verse mejor. Donde la plataforma tiene una limitación real — una ruta que todavía no existe, una regla de autorización que nos sorprendió, un cooldown que no se puede saltar — se señala explícitamente, nunca se esconde. Ver Known Limitations para la lista completa.

Los actores​

QuiénRolCómo llega a Ishtaran
MercattoEl marketplace — dueño de la Organization y la Application de IshtaranSu propia Application API Key, y (para algunas operaciones — ver Architecture) una sesión de Member
AliceCompradoraSu propio login self-service de AccountHolder — Mercatto nunca ve su contraseña
BobVendedorSu propio login self-service de AccountHolder, igual que Alice
Account de comisión de MercattoDonde aterriza la comisión propia del marketplaceUna Account normal, propiedad directa de Mercatto
IshtaranInfraestructura financieraNunca decide si los audífonos realmente se enviaron — eso solo lo sabe Mercatto

Capítulos​

  1. Architecture — la secuencia completa, cada llamada real
  2. Setup — Mercatto se registra
  3. Seller onboarding — Bob, Alice, y la Account de comisión propia de Mercatto
  4. Creating an order — Workflow + Transaction con un Split real
  5. Accepting payment — el Payment Intent y la dirección de depósito
  6. Holding funds — la reserva, y qué significa realmente "bloqueado"
  7. Confirming delivery — el evento que no es una compuerta
  8. Settlement and Split — Fee, Distributable Amount, el Split real
  9. Partial Settlement — liberar fondos en cuotas
  10. Seller balance — cómo se entera Bob de que le pagaron
  11. Withdrawal — y el cooldown real que lo bloquea
  12. Failure scenarios — 11 caminos alternativos reales, todos probados en vivo
  13. Full source — cada archivo, en una sola página
  14. Known limitations — limitaciones reales, nunca ocultas
  15. Run it yourself — contra el Sandbox público real, sin acceso privado necesario