Construye un Marketplace con Ishtaran
Alice le compra a Bob a través de Mercatto. Ishtaran retiene el pago hasta que se confirma la entrega, y luego lo divide entre el vendedor y el marketplace — un Business Case ejecutable, no una presentación.
Architecture
La secuencia completa — cada llamada real del SDK que hace Mercatto, y qué módulo de Ishtaran la maneja por debajo.
Setup
Mercatto se registra — una sola llamada provisiona todo lo que necesita para empezar a integrar.
Seller onboarding
Bob y Alice obtienen cada uno su propia identidad financiera — Mercatto nunca controla su login.
Creating an order
El ciclo de vida del pedido se convierte en un Workflow, y la Transaction declara exactamente quién recibe qué.
Accepting payment
Mercatto abre un Payment Intent y recibe una dirección de depósito real para que Alice pague.
Holding funds
La reserva es como poner el dinero en una caja etiquetada: está ahí, es real, pero todavía no se puede gastar.
Confirming delivery
Ishtaran no tiene ninguna forma de saber que los audífonos llegaron — Mercatto tiene que decírselo.
Settlement and Split
Ishtaran abre la caja: calcula el Platform Fee, y luego divide el resto exactamente como el pedido dijo que debía hacerse.
Partial Settlement
Mercatto no tiene que liberar todo de una vez — puede hacer el settlement en cuotas, con su propio calendario.
Seller balance
Bob ya tiene dinero — pero no lo revisa él mismo; lo hace el propio dashboard de Mercatto, tal como funciona un marketplace real.
Withdrawal
Bob quiere sacar su dinero — y choca con un cooldown de seguridad real y deliberado de 24 horas, probado en vivo, nunca saltado.
Payout por lotes: la otra PayoutPolicy real
La otra PayoutPolicy real: Manual. Un Settlement acumula un Payable en lugar de pagar de inmediato, y una llamada separada a PayoutBatch es lo que realmente mueve el dinero — cuándo usar cada una, y el bootstrap real que necesita.
Failure scenarios
11 caminos alternativos reales — casos límite de onboarding, pago, workflow y settlement — cada uno ejecutado en vivo contra una instancia real, no simulado.
Full source
Cada archivo, en una sola página — el código exacto que comparten este tutorial completo y la suite E2E que bloquea los releases.
Known limitations
Cada limitación real de la plataforma que encontró este Business Case, en un solo lugar — referenciada a lo largo del tutorial, nunca oculta.
Run it yourself
Corre esta historia exacta contra el Sandbox público real — IDs reales, balances reales, respuestas reales.