Página de pago

Tu página de pago

Cada tienda tiene su propia página de pago en /pay/<store>, donde <store> es el nombre corto de tu tienda. Ahí los clientes pueden ingresar un monto o elegir uno de tus enlaces de pago. Compártela en cualquier lugar donde hables con tus clientes: tu sitio web, tus perfiles en redes sociales, chats o correos.

Encontrarás el enlace en el portal, en Tu página de pago.

La página de la factura

Cada factura tiene su propia página en /pay/i/<invoice_id>. La API devuelve este enlace como checkout_url. En ella, el cliente:

• elige una moneda y una red entre las que aceptas;
• ve una dirección de depósito creada para esta factura, con un código QR, y el monto exacto que debe enviar, a un tipo de cambio fijado en ese momento;
• puede cambiar a otra moneda hasta que se detecte un pago;
• ve cómo cambia el estado en vivo: esperando, confirmando y pagada.

Cada factura está abierta durante un tiempo limitado, que se muestra como una cuenta regresiva. Si el tiempo se acaba antes de que se detecte algún pago, la factura vence. Si defines una redirect_url, el cliente puede volver a tu sitio después de pagar.

Si un cliente pagó pero el pago no apareció antes de que venciera la factura, puede informarlo desde la página de la factura. Entonces la dirección sale de rotación y queda en vigilancia, y nuestro equipo de soporte revisa el pago.

Enlaces de pago

Un enlace de pago es un enlace reutilizable para un producto, servicio o donación, en /pay/l/<link_id>. Ponle un título y un monto fijo, o deja el monto vacío para que el cliente lo ingrese. Cada pago hecho con un enlace se convierte en su propia factura.

Crea enlaces en el portal, en Enlaces de pago, o con la API.

Vistas previas al compartir

Cuando compartes un enlace de pago o tu página de pago en WhatsApp, Telegram, Instagram, X y apps similares, la app muestra una tarjeta de vista previa. Incluye el nombre de tu tienda, tu dominio verificado si tienes uno y las monedas que aceptas. En un enlace de pago, también muestra el producto y su precio.

Los enlaces de pago no aparecen en los buscadores, así que un enlace solo llega a las personas con quienes lo compartes.

Dominio verificado

Si verificaste el dominio de tu sitio web, tu página de pago, tus enlaces de pago, las páginas de factura y las páginas de reembolso lo muestran junto al nombre de tu tienda, por ejemplo shop.com · verificado. Así los clientes saben que la tienda de la página controla el DNS de ese dominio. Consulta cómo verificar tu dominio.

Tipos de cambio

Las facturas tienen un precio en una moneda como el dólar estadounidense. Cuando el cliente elige una moneda, el monto en esa moneda se calcula con precios en vivo y se fija. Las stablecoins como USDT y USDC valen un dólar estadounidense cada una. Si el pago se detecta por primera vez mientras la factura sigue abierta, se aplica el tipo de cambio fijado.

Clientes que pagan desde un exchange

Los exchanges suelen descontar su comisión de retiro del monto que escribe el cliente, así que llega menos de lo que se envió. Es la causa más común de las facturas con pago incompleto. La página de la factura tiene un aviso ¿Pagas desde un exchange? que le pide al cliente que se asegure de que llegue el monto completo.

Cuando está disponible la comisión de retiro de Binance para esa moneda y red, el aviso también muestra la comisión y el total que hay que ingresar en Binance. Otros exchanges cobran sus propias comisiones, que el cliente debe revisar en la pantalla de retiro.

Moneda o red equivocada

A veces los clientes pagan en una moneda distinta de la que pedía la factura, o por otra red. Crypto Merchant vigila la dirección de cada factura para todas las monedas compatibles, en todas las redes compatibles que usan esa dirección, así que estos pagos se detectan.

Una misma dirección EVM funciona en Ethereum, BNB Smart Chain, Polygon, Base y Arbitrum One, y guardamos su clave en todas ellas. Así, USDC enviado por Base a una factura que pedía USDC en Ethereum llega igualmente a una dirección que controlamos. Tron, Bitcoin, Litecoin, Solana, TON y XRP Ledger tienen cada una su propio tipo de dirección. En esas redes, esto cubre una moneda distinta en la misma red, por ejemplo TRX enviado a una factura de USDT en Tron.

Cuándo se contabiliza automáticamente

El pago cuenta para la factura por sí solo cuando se cumplen estas dos condiciones:

• todavía no se ha pagado nada más en la factura;
• las monedas cubren el monto de la factura, dentro de tu tolerancia para pagos incompletos.

Entonces la factura cambia a la moneda que realmente se envió. La página de la factura le indica al cliente en qué moneda pagó en lugar de la que se pedía. Tú ves la Moneda solicitada en el pago y en el correo del pago. En la API, coin es lo que se pagó y requested_coin es lo que pedía la factura.

Las monedas se valoran así:

• las stablecoins como USDT y USDC cuentan como un dólar estadounidense cada una;
• la misma moneda en otra red, como ETH en Base para una factura en ETH en Ethereum, conserva el tipo de cambio que se le mostró al cliente;
• cualquier otra moneda se valora al precio de mercado del momento en que llegó.

Esto también funciona con los pagos tardíos: cuando la factura ya venció pero su dirección todavía está en vigilancia, lo que dura al menos 24 horas.

Montos menores y tokens sueltos

Todo lo demás nunca cambia la factura: un pago parcial en otra moneda, una segunda moneda en una factura que ya tiene un pago o un token suelto. Se acredita a tu saldo como un pago sin factura, menos la comisión del 1 %, y un ticket de soporte te avisa, para que puedas resolverlo con el cliente. Un token diminuto enviado a la dirección no puede apoderarse de una factura.

Un pago tardío a una factura cancelada o reembolsada se trata igual: se acredita a tu saldo y recibes un ticket.

Qué todavía se puede perder

Las monedas en una red o en una moneda que Crypto Merchant no admite, y las monedas enviadas a cualquier dirección distinta de la de la factura, no se pueden contabilizar y pueden perderse para siempre. Los clientes deben seguir enviando la moneda indicada, en la red indicada.

Facturas con pago incompleto

Defines una tolerancia para pagos incompletos en tu configuración; recomendamos al menos 1 US$. Si a un pago confirmado le falta, como máximo, el monto de la tolerancia, la factura cuenta como pagada.

Si al pago le falta más que eso, la factura queda con pago incompleto. Lo enviado se guarda para el cliente, que puede enviar el resto a la misma dirección o recibir el reembolso de lo que envió en una dirección que indique. La comisión de red del reembolso se descuenta del reembolso.

Facturas pagadas de más

Si un cliente envía más de lo que pide la factura, la factura igual cuenta como pagada. Lo que pasa con el excedente depende de su valor:

• La factura cuenta como pagada y el excedente se guarda para el cliente. Puede retirarlo a su propia billetera desde la página de la factura, menos la comisión de red por enviarlo.
• Hasta que lo haga, Crypto Merchant lo guarda para el cliente. No se suma al saldo del negocio y nunca se retiene como comisión.

Reembolsos después de un pago

Puedes devolver dinero de un pago completado, por ejemplo por una devolución o un pedido cancelado. Abre el pago en el portal y usa Reembolsar este pago. Solo los administradores pueden hacerlo, y primero confirman que son ellos con un código nuevo de su correo o de su app de autenticación.

• Puedes reembolsar cualquier monto hasta lo que te quedó de ese pago: lo que se te acreditó después de la comisión del 1 %, menos los reembolsos anteriores y los enlaces de reembolso que sigan abiertos. La comisión del 1 % no se devuelve.
• El monto se reserva de tu saldo de inmediato, para que no se pueda retirar por error mientras tanto.
• Si el pago tiene el correo del cliente, este recibe un correo con un enlace privado. También puedes copiar el enlace y enviarlo tú.
• El cliente abre el enlace, ingresa su propia dirección para esa moneda y red, marca una confirmación y envía. El reembolso sale de tu billetera pool, y la comisión de red se descuenta del reembolso.
• Un enlace queda abierto durante 14 días. Si el cliente no lo reclama a tiempo, o si lo cancelas, el monto vuelve a tu saldo automáticamente. Cada enlace se puede reclamar una sola vez.

Un reembolso parcial mantiene el pago en estado Pagada y muestra el monto reembolsado. Si reembolsas todo lo que te quedó, el estado cambia a Reembolsada. Cada reclamo envía un webhook invoice.refunded, y el objeto factura muestra el total en refunded_amount.

Como el cliente escribe la dirección en la página de reembolso, nadie tiene que intercambiar direcciones por chat, donde un error de tipeo o un impostor pueden enviar las monedas al lugar equivocado. Las transferencias de cripto no se pueden revertir, así que el cliente debe ingresar una dirección que controle, en la red indicada.

Las facturas con pago incompleto siguen teniendo su propia opción de reembolso para el cliente en la página de la factura, y los clientes todavía pueden retirar desde ahí un excedente, como se describe arriba. Un reembolso no recupera las partes ya reservadas para los socios del reparto de ingresos.

Comisiones

El 1 % de cada factura pagada se descuenta cuando el pago se acredita a tu saldo. Las facturas vencidas y canceladas no cuestan nada.

No hay comisión adicional cuando un pago se contabiliza tras llegar en otra moneda o por otra red. Cuando reembolsas un pago, la comisión del 1 % no se devuelve, y la comisión de red del reembolso se descuenta del reembolso.

El monto a pagar también incluye una comisión de gas por mover ese pago a tu billetera pool, nunca más de 5 US$. En la mayoría de las redes son unos pocos centavos. USDT en Tron cuesta más, porque Tron quema energía en cada transferencia de tokens. La página de pago muestra la comisión junto al precio, y la API la devuelve como network_fee_amount y network_fee_usd. Cubre el barrido de ese pago, no son tus ingresos y no se cobra comisión por pago sobre ella.