Preguntas frecuentes

Preguntas que deciden la adopción de pagos

Respuestas claras para equipos que comparan opciones de checkout cripto, liquidación, pagos masivos y patrocinio de gas.

Revisado editorialmente con referencias de producto, API y políticas. Acerca de · Docs API · Política AML/KYC · llms.txt

Empezando

Cree una cuenta de comerciante, agregue una billetera de pagos, elija la red y el token, luego publique su enlace, widget o botón de pago.
When you create a payment session using a test API key (sk_test_...) on any testnet network, both the hosted checkout page (/test/{session_id}) and the REST API (POST /api/v1/payments/{id}/simulate) allow you to trigger instant simulated outcomes—Completed, Underpaid, Expired, or Failed—without needing testnet faucet tokens. Each simulation generates realistic ledger records and dispatches a signed webhook event to your callback URL.
Sí. Utilice flujos de testnet para validar el pago, la conexión de la billetera y el comportamiento de la factura antes de la producción.
No. Puede iniciar sin herramientas de código desde el panel del comerciante y usar la API solo cuando necesite integraciones avanzadas.
La mayoría de los comerciantes publican su primer flujo de pago criptográfico en minutos.

Pagos y Donaciones

Los enlaces de pago son flujos de pago fijos. Los enlaces de donación son flujos centrados en el apoyo a las contribuciones de la comunidad.
Sí. Cada sesión de pago completada incluye un generador instantáneo de recibos PDF-1.4 (/public/receipt.php?session_id={id}&download=1) y una vista HTML imprimible. El recibo muestra el ID de factura, ID de sesión, nombre del comercio, importe bruto, comisión de pasarela de XPayr, importe neto liquidado, token, red, direcciones de billetera de origen y destino, marca temporal UTC y hash de la transacción on-chain.
Sí. Los enlaces reutilizables pueden cobrar múltiples pagos a lo largo del tiempo según el flujo de su campaña.
Utilice un widget para el pago integrado, un botón para un llamado a la acción de marca y un enlace directo para compartir rápidamente en chats o redes sociales.
Sí. Puede permitir montos personalizados o mantener montos fijos según el flujo que configure.
Sí. XPayr cuenta con el Modo de Pago Dual: Pago Web3 en 1 Clic para transacciones directas con billeteras de navegador, y Transferencia Directa / QR para clientes que pagan desde exchanges centralizados (Binance, Bybit, OKX, etc.) o billeteras móviles. Los clientes pueden simplemente escanear el código QR o copiar la dirección del destinatario, transferir los fondos e ingresar su Hash de Transacción (TxID) o permitir que el explorador de la cadena detecte automáticamente el pago. Se incluye una tolerancia de deducción por retiro de red del 1% (máximo $0.50).
Al crear un enlace de pago o página de donación, los comerciantes pueden elegir "Todas las Redes (El cliente elige al pagar)". En lugar de restringir al pagador a una sola cadena o moneda, la pantalla de pago muestra un selector de red limpio. El cliente puede pagar usando EVM (Ethereum, BSC, Polygon, Arbitrum, Avalanche), TRON USDT o Solana, y el sistema carga automáticamente la ruta, los parámetros del contrato y la billetera del destinatario.

Monedero y Redes

XPayr admite carteras de navegador compatibles con EIP y flujos de conexión de carteras modernas.
La billetera seleccionada no está registrada para esa cadena en la configuración de su comerciante. Agréguelo y regístrelo para la red seleccionada.
Sí. Desconecte la billetera actual y vuelva a conectarse con la dirección que desea usar antes de crear o confirmar el pago.
Abra billeteras de pago en el panel de comerciantes, seleccione la red, pegue la dirección de la billetera y guárdela después de la validación.

Tarifas y liquidación

XPayr aplica una tarifa de entrada transparente del 0,5 por ciento. Las tarifas del gas de la red son costos de blockchain y varían según el estado de la cadena.
XPayr comienza con una comisión transparente de pasarela del 0.50% (50 bps) en el plan gratuito Starter ($0/mes). Los comercios pueden actualizar a Growth Pro ($49/mes para una comisión base del 0.30% / 30 bps) o Enterprise Scale ($199/mes para una comisión base del 0.15% / 15 bps). Además, XPayr calcula automáticamente tu volumen móvil de 30 días completado en mainnet en USD y aplica un descuento por Rango de Volumen: Bronze ($0+ = 0 bps), Silver ($10,000+ = -5 bps), Gold ($50,000+ = -10 bps) y Diamond ($250,000+ = -15 bps), reduciendo tu comisión efectiva de pasarela hasta un mínimo del 0.05% (5 bps).
El remitente de la transacción paga los costos del gas en cadena de acuerdo con las condiciones de la red y el flujo de token seleccionado.
Después de la confirmación en cadena, los fondos se mueven directamente al flujo de su billetera configurada.
Sin tarifas de entrada ocultas. Se ve claramente la tarifa de la plataforma y los costos de la red en el flujo.

Seguridad y cumplimiento

Utilice 2FA, controles de lista blanca y validación de firmas de webhooks para proteger las operaciones de cuentas y pagos.
No. La marca de confianza central permanece visible mientras los elementos de su marca se muestran en el encabezado de pago.
Restringe las acciones confidenciales a direcciones IP aprobadas y reduce las acciones administrativas no autorizadas.
Sí. Habilite la aplicación de la lista blanca para permitir pagos solo a pares de divisas y billeteras aprobados.

API y webhooks

Valide el encabezado de la firma con su secreto de webhook antes de procesar los datos de la carga útil.
Yes. Merchants can generate a dedicated HMAC secret in the API Keys dashboard and send X-Signature and X-Timestamp headers (with a 300-second anti-replay window) on API requests. When creating a payment session via POST /api/v1/payments, you can also pass ipn_url (or ipn_callback_url) to route webhooks dynamically per store/order, and allow_payment_methods (["web3", "direct", "gasless"]) to control which checkout tabs are shown to the buyer.
La clave API identifica el contexto de integración. La clave secreta autoriza solicitudes de API del lado del servidor protegido.
Los estados comunes incluyen pendiente, confirmado, fallido y caducado con eventos de actualización relacionados.
Utilice la idempotencia en su backend y almacene los identificadores de eventos procesados ​​antes de aplicar actualizaciones comerciales.
Sí. Al crear una sesión mediante POST /payments o el portal de comerciantes, establezca send_invoice_email en true e ingrese customer_email. XPayr envía de inmediato una factura por correo electrónico HTML responsive y con marca que incluye los detalles del pago y un botón de pago en 1 clic. Los webhooks se activan al completarse el pago.

Solución de problemas

Esto generalmente significa una discrepancia de red, una discrepancia de token, un registro de billetera faltante o un rechazo de validación de contrato.
Verifique que la factura pertenezca a su cuenta de comerciante y que los datos de la sesión existan en el entorno actual.
La sesión alcanzó su límite de tiempo o ya fue finalizada por un flujo completo.
Verifique que la extensión de billetera esté instalada, desbloqueada, en la cadena correcta y que las ventanas emergentes no estén bloqueadas por la configuración del navegador.

Cuenta y equipo

Sí. Los equipos pueden compartir flujos de trabajo operativos mientras los controles de pago permanecen centralizados.
Utilice el flujo de contraseña olvidada y los pasos de recuperación, luego actualice la configuración de seguridad después de restaurar el acceso.
Abra las claves API en el panel del comerciante para crear, rotar y revocar credenciales.
Sí. Los usuarios administradores pueden omitir la página de mantenimiento mientras los visitantes públicos aún ven la pantalla de mantenimiento.

Programa de Socios y Afiliados

XPayr ofrece una infraestructura híbrida de socios que admite el seguimiento corporativo de Web2 (mediante Impact.com S2S) y liquidaciones directas por contratos inteligentes Web3.

Al referir a un comerciante o desarrollador, ganas comisiones recurrentes del 30% sobre las tarifas de procesamiento o bonos CPA de $50 por comerciante activo.
Cuando un visitante hace clic en tu enlace de afiliado, XPayr guarda el identificador de clic durante 30 días.

Cuando el usuario realiza una compra o activa su tienda, XPayr ejecuta un postback Server-to-Server (S2S) a Impact.com, garantizando un seguimiento 100% preciso inmune a bloqueadores de anuncios.
Puedes elegir entre dos modelos:

1. 30% RevShare Recurrente: Gana el 30% de la tarifa del 0.5% de XPayr de por vida en cada transacción.
2. $50 CPA por Activación: Recibe $50 una vez que el comerciante procese sus primeros $100.
Conecta tu billetera en el Panel de Comerciante (/merchant/affiliate).

El contrato inteligente asigna tu 30% automáticamente. Haz clic en 'Claim' para retirar USDT, USDC o SOL sin intermediarios.
Visita el Estudio de Recursos de marca en /brand-assets.

Puedes generar insignias SVG dinámicas y copiar códigos de inserción para banners estándar (728x90, 300x250, 1200x630).
No. Las autorreferencias, el volumen artificial y las transacciones en redes de prueba están estrictamente excluidas por los filtros antifraude.

¿Cómo verifica XPayr las afirmaciones sobre pagos y contenidos?

XPayr vincula las afirmaciones públicas con fuentes de producto, políticas y gobernanza para que los comercios y los sistemas de IA puedan verificar cada declaración rápidamente.