Casos de uso

Acepta pagos con cripto en una tienda en línea, sin plugin

Una tienda en línea acepta cripto con Crypto Merchant creando una factura por pedido mediante la API REST y enviando al cliente a la página de pago alojada de la factura. El cliente elige una moneda, paga el monto exacto a un tipo de cambio fijado para esa factura, y tu servidor despacha el pedido cuando llega el webhook firmado invoice.paid. La comisión es del 1 % por factura pagada. No hay plugin para WooCommerce, Shopify ni Magento: la integración es una llamada a la API y un endpoint de webhooks.

Actualizado el 6 de noviembre de 2026

Todo lo que hay en esta página describe cómo funciona Crypto Merchant hoy, tal como se detalla en la referencia de la API, la documentación de la página de pago y Precios. Nada de lo que hay aquí es una afirmación sobre otras pasarelas.

De un vistazo

Tema	Cómo funciona
Cómo pagan los clientes	En una página de factura alojada: eligen una moneda y una red entre las que aceptas, ven el monto exacto y una dirección de depósito creada para esa factura, con un código QR y una cuenta regresiva.
Qué construyes	Una llamada a `POST /invoices` cuando el cliente elige cripto, y un endpoint HTTPS para los webhooks. Cualquier lenguaje o framework que pueda hacer una solicitud HTTPS.
Cuándo despachar	Con el evento `invoice.paid`, después de que el pago tiene sus confirmaciones. Nunca con `invoice.confirming`.
Montos incorrectos	Un pago al que le falta, como máximo, tu tolerancia cuenta como pagado. Si falta más, la factura queda `underpaid`: el cliente puede completar el pago o recuperar lo que envió. Un pago de más cuenta igual como pagado, y el excedente se guarda para el cliente.
Moneda de los precios	Dólares estadounidenses de forma predeterminada, u otra moneda admitida como EUR, GBP, TRY o BRL; el monto en la moneda elegida se calcula con precios en vivo cuando el cliente la elige.
Plugins	Ninguno. El flujo de abajo funciona con cualquier carrito o checkout propio que pueda llamar a una API.

¿Cómo funciona, paso a paso?

Desde el momento en que un cliente elige “Pagar con cripto” hasta que el pedido sale de tu almacén:

1
Crea la factura al finalizar la compra
Cuando el cliente elige cripto, tu servidor llama a POST /invoices con el total del pedido, tu order_id, el correo electrónico del cliente, una redirect_url de vuelta a tu página de agradecimiento y cualquier metadata que quieras recibir de vuelta. La respuesta es la factura con una checkout_url.
2
Envía al cliente a la página de la factura
Redirige a checkout_url. La página muestra las monedas que aceptas; cuando el cliente elige una, el monto en esa moneda se calcula con precios en vivo y se fija, y se muestra una dirección de depósito creada para esta factura, con un código QR. La factura permanece abierta durante el tiempo que definas, 30 minutos de forma predeterminada.
3
Recibe los webhooks firmados
Tu endpoint recibe invoice.confirming cuando el pago se detecta en la cadena e invoice.paid cuando tiene suficientes confirmaciones. Verifica el encabezado CM-Signature, guarda el evento, responde con un 2xx en menos de 10 segundos y después libera el pedido a partir de tu copia guardada. Los eventos pueden llegar dos veces: usa el id del evento para despachar una sola vez.
4
Maneja los tres casos especiales
invoice.expired: no llegó ningún pago a tiempo, así que ofrece una factura nueva. invoice.underpaid: el cliente puede enviar el resto a la misma dirección o pedir un reembolso desde la página de la factura. Una factura pagada de más sigue estando pagada; el excedente se guarda para el cliente, que puede retirarlo desde la página de la factura.
5
Recibe tu retiro
Los pagos confirmados se acreditan a tu saldo menos el 1 % y se barren a la billetera pool de tu negocio. Retira cuando quieras a tus propias direcciones, cada moneda tal como está o todo convertido a una sola moneda de reserva.

La única llamada a la API que hace falta

Crea la factura al finalizar la compra

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "64.00",
    "currency": "USD",
    "order_id": "ORD-20931",
    "description": "Order ORD-20931",
    "customer_email": "[email protected]",
    "redirect_url": "https://yourstore.example/orders/20931/thanks",
    "metadata": { "cart": "20931" }
  }'

# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.

¿Cuánto cuesta?

El 1 % de cada factura pagada, que se descuenta cuando el pago se acredita a tu saldo. No hay costo de configuración, ni cuota mensual, ni pago para activar la cuenta; las facturas vencidas y canceladas no cuestan nada. Mover monedas (barridos, conversiones y retiros) conlleva una comisión de gas, que se paga con tu saldo de gas si agregas uno o, si no, se descuenta de las monedas que se están moviendo. Los clientes también pagan una comisión de gas en cada factura: se suma al monto que envían, se muestra en la página de pago y nunca supera 5 US$. Los tipos de cambio de las conversiones incluyen un margen de servicio del 1 %. Todos los costos están en una sola tabla en Precios.

Lo que Crypto Merchant no hace aquí

Sin plugin para tiendas. No hay módulo para WooCommerce, Shopify, Magento, PrestaShop ni OpenCart. Tú agregas la llamada a la API, o compartes tu página de pago y tus enlaces de pago.
Sin reembolsos automáticos ni llamada de reembolso en la API. Un pago con cripto confirmado es definitivo, así que un reembolso es una nueva transferencia. Para una devolución, un administrador crea un enlace de reembolso privado desde el pago realizado en el portal; el cliente ingresa su propia dirección, la comisión de red se descuenta del reembolso y la comisión del 1 % no se devuelve.
Custodio, solo cripto. Crypto Merchant guarda las claves hasta que retiras, y los retiros van a tus propias direcciones de billetera, no a una cuenta bancaria.

¿Para quién es?

Tiendas que ya tienen su propio checkout y pueden agregar una llamada a la API y un webhook.
Tiendas que venden a clientes en países donde es difícil conseguir tarjetas o donde los contracargos duelen.
Tiendas que ponen precios en dólares y quieren liquidar en USDT o USDC.

Preguntas frecuentes

¿Hay un plugin de WooCommerce o Shopify para Crypto Merchant?

No. La integración es una llamada a la API que crea una factura y un endpoint de webhooks que se entera cuando se paga. Si un plugin es imprescindible, las páginas de alternativas enumeran pasarelas que tienen uno.

¿Cuánto tarda en confirmarse un pago con cripto?

Depende de la red. Cada red tiene un número fijo de confirmaciones, indicado en Monedas y redes. Las stablecoins en Tron, Solana, BNB Smart Chain, Polygon, Base y Arbitrum suelen confirmarse en pocos minutos; Bitcoin necesita 2 confirmaciones, normalmente unos 20 minutos.

¿Qué pasa si el cliente paga un monto incorrecto?

Si lo que falta está dentro de tu tolerancia, cuenta como pagado. Si falta más, la factura queda con pago incompleto, y el cliente puede completar el pago o recuperar lo que envió desde la página de la factura. Un pago de más cuenta igual como pagado, y el excedente se guarda para que el cliente lo retire.

¿El cliente necesita una cuenta de Crypto Merchant?

No. El cliente solo necesita una billetera con la moneda con la que quiere pagar. Abre la página de la factura, elige la moneda y envía el monto que se muestra.

¿Puedo poner los precios de los pedidos en euros u otra moneda?

Sí. Las facturas tienen precio en dólares estadounidenses de forma predeterminada, y el campo de moneda acepta otras monedas admitidas como EUR, GBP, TRY o BRL. El monto en la moneda elegida se calcula con precios en vivo cuando el cliente la elige.

Otros casos de uso

Todos los casos de uso

Empieza a aceptar cripto hoy

Configuración gratis, sin documentos para registrarte, 1 % por factura pagada y retiros cuando quieras.

Crea tu cuenta Leer la documentación