RugWard Pay
Facturas, enlaces de pago y pagos de prueba
Crea facturas en el panel, comparte enlaces y botones de pago reutilizables, prueba gratis todo el proceso de pago en una testnet y gestiona los pagos sin coincidencia.
En esta página
Crear una factura#
En el panel, rellena New invoice y haz clic en Create invoice. Obtienes un enlace de pago para enviar a tu comprador (https://rugward.com/pay/i/<id>).
| Campo | Reglas | Notas |
|---|---|---|
| ① Amount (USD) | de 1 $ a 50.000 $, como máximo 2 decimales (25 o 25.50) | El comprador paga el equivalente en la moneda que elija. |
| ② Expires after | 30 minutos, 1 hora (por defecto), 3 horas, 1 día o 7 días en el panel; de 15 minutos a 7 días con la API | Tras el vencimiento, la página de pago indica "Do not send anything" y no se puede fijar un nuevo tipo de cambio. |
| ③ Order id (opcional) | hasta 64 caracteres: letras, dígitos y . _ - : # / | Tu propia referencia; se devuelve en la API y en los webhooks. |
| ④ Return URL (opcional) | dirección https:// completa | Se muestra al comprador solo después de pagar la factura, como un botón "Return to <tu sitio>". |
| Description (opcional) | hasta 200 caracteres | Se muestra al comprador, por ejemplo "1 × camiseta, talla M". |
El comprador elige la moneda en la página de pago. El tipo de cambio queda fijado 30 minutos desde ese momento (no desde la creación de la factura), así que una factura de larga duración no te expone a variaciones de precio.
Envía el pedido solo cuando el panel (o el webhook invoice.paid) indique Paid. Que un comprador llegue a tu URL de retorno no prueba el pago: cualquiera puede abrir una URL.
Lista y detalles de facturas#
Invoices muestra tus últimas facturas con fecha, importe, id de pedido y estado. Details abre una factura: las cotizaciones (moneda, importe, tipo de cambio, dirección), cada pago visto on-chain con sus confirmaciones y enlace al explorador, y los botones Open checkout, Payment proof (facturas pagadas) y Cancel invoice.
Etiquetas de estado que verás:
| Etiqueta | Estado en la API |
|---|---|
| Awaiting payment (esperando pago) | open |
| Payment detected, confirming (pago detectado, confirmando) | pending |
| Paid (pagada) | paid |
| Paid (more than requested) (pagada de más) | overpaid |
| Underpaid (pago insuficiente) | underpaid |
| Paid after expiry (pagada tras vencer) | late |
| Expired (vencida) | expired |
| Canceled (cancelada) | canceled |
Qué significa cada una y qué hacer: Estados, confirmaciones y pruebas.
Cancelar una factura#
Puedes cancelar tu propia factura mientras esté open y no se haya visto ningún pago. La página de pago indica entonces al comprador "The merchant canceled this invoice. Do not send anything to it." Webhook: invoice.canceled. Una factura con un pago en camino no se puede cancelar (409).
Enlaces y botones de pago#
Un enlace de pago es un enlace reutilizable con precio fijo: un producto, una donación, una membresía mensual. Cada comprador que hace clic en Pay with crypto obtiene su propia factura nueva (válida 60 minutos), así que los pagos nunca se mezclan.
- Introduce el importe en USD, una descripción y una URL de retorno opcional, y luego Create link.
- El panel muestra la vista del comprador (exactamente lo que ven los compradores), el enlace
https://rugward.com/pay/l/<id>y cuántas veces se ha usado. - Copy link para compartirlo en un chat, un correo o redes sociales, o Copy button HTML para poner un botón "Pay with crypto" en tu web.
- Turn off desactiva el enlace. Las facturas ya creadas a partir de él no se ven afectadas.
El botón es un enlace HTML simple. No carga ningún script ni crea cookies:
<a href="https://rugward.com/pay/l/k33JZ0ij5F2yLDprwrQgjN" target="_blank" rel="noopener"
style="display:inline-block;padding:10px 20px;border-radius:12px;background:#f0b90b;color:#000;font:600 15px system-ui,sans-serif;text-decoration:none">Pay with crypto</a>
Conviene saber:
- Las facturas creadas desde un enlace llevan el id de pedido
link:<primeros 8 caracteres del id del enlace>, para distinguirlas en la lista, la API y los webhooks. - Límites: 100 enlaces activos por comerciante; un enlace crea como máximo 100 facturas por hora (protege tu cupo horario de facturas frente a abusos). Abrir un enlace está protegido por Cloudflare Turnstile cuando hace falta.
Facturas de prueba (gratis, testnet Sepolia)#
Abre Test invoice (Sepolia testnet) en el panel para probar todo el proceso de pago sin dinero real. El comprador paga con ETH de prueba de Sepolia o con el USDC de prueba de Sepolia de Circle a través del splitter de RugWard Pay desplegado en Sepolia, que envía el 99,5% a la dirección de cobro y el 0,5% a la billetera de comisiones de RugWard, exactamente como en Base.
- Importe: de 1 $ a 100 $. Dirección de cobro de prueba opcional (una dirección EVM); si no, se usa tu dirección EVM.
- Las monedas de prueba no tienen valor. Son gratuitas: ETH de Sepolia de un faucet (por ejemplo el faucet de Sepolia de Google Cloud) y USDC de prueba del faucet de Circle (elige Ethereum Sepolia).
- Las facturas de prueba llevan la marca TEST en la página de pago, en la lista y en la prueba; nunca llaman a tu webhook y no se pueden crear con una clave de API, así que una prueba nunca puede provocar el envío de un pedido real.
Pagos sin coincidencia#
A veces llega una transferencia a tu dirección que no coincide exactamente con una factura: un importe incorrecto, un pago enviado mucho después del vencimiento o una transferencia sin relación. RugWard nunca los marca como pagados automáticamente. Si hay alguno, el panel muestra un recuadro Unmatched payments con el importe, la red, el enlace a la transacción y la factura que se estaba comprobando cuando se vio.
Qué hacer: abre la transacción, contacta con el comprador y resuélvelo tú mismo (entrega el pedido o devuelve el dinero desde tu billetera). Luego haz clic en Dismiss.
Última actualización: 30 de octubre de 2026