Un checkout de tres vendedores, comisión del 4% y una política de pagos revisada.
1. Prepara el proyecto
Abre Proyecto → Marketplace → Ajustes. Activa Marketplace y selecciona tiendas. Deja los pagos pausados. Haz copia de las wallets y activa Bitcoin o métodos EVM compatibles en cada tienda.
El cliente paga primero a estas wallets. Tú controlas las claves y debes los saldos registrados a los vendedores. Mantén monedas nativas libres aparte para tasas. El sweep normal no puede gastar las direcciones Marketplace.
2. Añade y aprueba tres vendedores
En Vendedores añade cada vendedor y una dirección Bitcoin mainnet. Confírmala con el vendedor por otra vía antes de aprobarla. Para tokens EVM también necesita dirección aprobada en esa red exacta.
Fija la comisión del proyecto en 4%. Los ajustes de tienda, vendedor y factura autorizada se guardan; editarlos después no cambia un reparto existente.
3. Crea la factura compartida
En Marketplace → Facturas crea 300 USD con tres partes brutas de 100 USD. La suma debe ser exacta. Envía el enlace de pago al cliente.
Para la API usa una clave Marketplace separada y envía cadenas decimales a /v1/marketplace/invoices. Guarda la clave de idempotencia antes de solicitar y reutilízala tras un timeout. Ejemplos de solicitudes →
4. Revisa y envía
Espera los repartos verificados disponibles. Al tipo fijado cada vendedor recibe 96 USD equivalentes y conservas 12 USD de comisión. Si la tasa de procesamiento está al 1%, usa 3 USD de saldo prepago. Las tasas de red van aparte.
En Pagos prepara repartos disponibles y limita tasas nativas y gas. Bitcoin exige todas las partes impagadas de cada factura en el mismo lote. Revisa destinatarios y plan exactos, aprueba una vez y sigue hasta Paid, no solo Broadcast.
5. Activa la automatización con cuidado
En Ajustes añade política por activo: mínimo, límites por pago y día, presupuestos nativos y gas, intervalo y confirmaciones. Actívala solo tras revisar límites y destinos; después reanuda pagos.
Las políticas automáticas pueden enviar sin más clics. Saldo bajo o bloqueo de transferencias del servidor pausan el gasto, pero seguimiento y contabilidad continúan.
6. Resuelve excepciones sin duplicar envíos
- Pago insuficiente: la tolerancia no crea saldos sin fondos. Espera más pago, reembolsa o aprueba expresamente un reparto menor cubierto.
- Falta gas: añade monedas nativas libres a la wallet y revisa el pago guardado. No crees otro pago para saltarlo.
- Timeout de webhook: reintenta el mismo evento firmado. Verifica firma del cuerpo y proyecto, guarda event_id único y confirma. Factura liquidada no significa pago al vendedor completado.
- Reembolso tras pagar vendedores: financia aparte la dirección principal, verifica dirección del cliente, prepara reembolso completo en el mismo activo y aprueba. No se cobra automáticamente a vendedores.
- Restauración o difusión incierta: deja pagos pausados y concilia los hashes guardados antes de continuar. Un timeout no demuestra que no se envió nada.