Pagos / Marketplace

Arquitectura de referencia: checkout cripto y pagos a proveedores

Un marketplace cobra a compradores y paga a vendedores. Este build usa las primitivas de pago para la mitad entrante y las de payout para la saliente, reconciliadas mediante webhooks firmados.

El desafío

Cobrar y desembolsar cripto suele implicar un procesador para un lado y herramientas de custodia para el otro. El objetivo es operar ambas direcciones sobre un saldo con entrega de eventos consistente y verificable.

Primitivas usadas
  • Invoices / checkoutC2
  • Mass payout / settlementC2
  • Build / sign / broadcastC2
  • Webhook (HMAC) deliveryC1

Cobrar con invoices

Crea una invoice por pedido y presenta el checkout alojado. El subpago, sobrepago y las confirmaciones se rastrean por ti.

Reconciliar con webhooks firmados

La liquidación dispara un webhook firmado con HMAC e idempotente. Verifica la firma y marca el pedido como pagado; las entregas duplicadas no acreditan dos veces.

Desembolsar con pago masivo

Paga a los vendedores en lote desde el mismo saldo, difundiendo transferencias y rastreando cada una hasta su confirmación.

Lo que entrega la arquitectura

  • Cobro entrante y pagos salientes sobre un solo saldo
  • Webhooks idempotentes y firmados para que la reconciliación no cuente doble
  • Sin contratos separados de procesador y custodia que mantener

Preguntas frecuentes

¿Cómo se evita el doble abono?

La entrega de webhooks es idempotente y firmada; un evento de liquidación duplicado se reconoce y se ignora.

¿Cobro y payout pueden compartir fondos?

Sí: ambos operan contra un saldo, así que los fondos cobrados pueden liquidar pagos salientes.

Recarga, obtén tu clave y publica.

Autoservicio. Paga en cripto o con tarjeta. Medido por créditos: las primitivas pesadas cuestan más, las simples son baratas.

Obtener clave API