Cómo añadir pagos cripto a una tienda online

Decide primero

Cuatro decisiones evitan rehacer trabajo después.

1. Qué activos y redes. Empieza poco a poco: USDT y USDC cubren a la mayoría de los clientes. Qvard admite USDT, USDC, BTC, LTC, TRX, BNB y ETH, en las redes TRC20, ERC20, BEP20, Bitcoin y Litecoin.
2. Precio en dólares. Mantén tus precios como están. El pago se crea en dólares estadounidenses y el importe cripto exacto se muestra en la página de pago, con la tasa fija durante una hora.
3. Qué activa un pedido pagado. Envío, una clave de licencia, acceso a contenido. Decide qué ocurre en el momento en que el pago se completa.
4. Qué haces cuando algo sale mal. Pagos cortos, reembolsos, un cliente que pagó por la red equivocada. Escribe la regla ahora.

Pasos de integración

Qvard aún no tiene plugins listos para tiendas, así que una tienda se integra mediante la API. Son dos piezas de código de servidor.

1. Crea un pago cuando el cliente elige cripto. Un POST a https://api.qvard.com/api/v1/payment con tu número de pedido como id y el total del pedido en dólares estadounidenses como price, autenticado con tu clave de API. La respuesta contiene un redirectUrl; envía al cliente allí.
2. Recibe el resultado. Guarda una URL de callback en el panel. Cuando el pago se completa, Qvard envía un POST con tu número de pedido y el estado. Marca el pedido como pagado y activa el cumplimiento. Responde exactamente HTTP 200.
3. Haz el manejador seguro. Puede entregarse más de una vez, así que una repetición no debe cambiar nada.

Las versiones detalladas: cómo aceptar pagos cripto en un sitio web para el flujo genérico, WordPress y WooCommerce para esas plataformas, y la API de pagos cripto para desarrolladores como referencia.

Asigna los estados a los de tu pedido

Un pago tiene cuatro estados: wait, partial, completed y rejected. Tu pedido necesita estados equivalentes, y el webhook llega solo con completed.

• Pedido creado y sin pagar corresponde a wait.
• Un pago corto corresponde a partial: mantén el pedido en espera y pide al cliente la diferencia.
• Un pedido pagado corresponde a completed: cúmplelo.
• rejected: trata el pago como fallido y deja que el cliente lo reintente.

La asignación completa, con código, está en pagos cripto para el comercio electrónico.

Redacción en el checkout

La mayoría de los tickets de soporte sobre cripto vienen de textos poco claros. En el paso de pago:

• nombra las monedas y redes aceptadas;
• di que el importe debe enviarse completo y por la red que muestra la página de pago;
• indica que la tasa queda fija durante una hora;
• explica cómo funcionan los reembolsos y dónde obtener ayuda.

Qvard aún no ofrece URL de retorno, así que el cliente aterriza en la página de pago y tú le dices qué ocurre después. Una página de pedido clara que se actualiza tras el webhook, más un correo de confirmación, sustituye la redirección.

Prueba y salida a producción

Aún no hay sandbox, así que prueba con cantidades reales pequeñas.

1. Paga una pequeña cantidad real y observa todo el recorrido: pago creado, cliente pagó, webhook recibido, pedido marcado como pagado.
2. Haz que el endpoint falle una vez y confirma que el reintento (cinco intentos en unos seis minutos) no cumple el pedido dos veces.
3. Retira una pequeña cantidad a tu propia wallet para comprobar ese paso. Cuesta solo la comisión de red.
4. Añade cripto al checkout y vigila los primeros pedidos.

Tras el lanzamiento, mantén una rutina breve; la lista está en la lista de comprobación operativa para pagos cripto. Coste: sin cuota de suscripción, y la comisión, individual para tu proyecto, empieza en el 1 % y puede bajar hasta el 0,1 % según la página de precios.

FAQ