Integración con contratos inteligentes

Acepta pagos en criptomonedas directamente en tu propia billetera con los contratos inteligentes de Volet.com. Tus clientes conectan sus billeteras cripto y aprueban las transacciones, y el contrato inteligente procesa el pago y distribuye los fondos y la comisión de procesamiento on-chain.

Ni tú ni tus clientes necesitan una cuenta de Volet.com. Tú controlas la billetera receptora y gestionas la confirmación de los pagos desde tu propia aplicación.

Importante: esta integración no usa Hosted Checkout ni facturas de la Merchant API. Tu aplicación ofrece la interfaz de pago y verifica los pagos directamente en la blockchain. Volet.com no envía notificaciones del estado del pago en este flujo.

Cómo funciona

Una integración de pagos no custodiales tiene tres componentes:

• Tu aplicación: crea los pedidos, inicia los pagos y verifica las transacciones.
• La billetera del cliente: se conecta a tu aplicación y firma las transacciones de pago.
• El contrato inteligente de Volet.com: procesa los pagos, transfiere los fondos a tu billetera y cobra la comisión de procesamiento.

Flujo de pago

1. Crea un pedido. Tu backend registra el monto del pago, el activo, la red blockchain y la billetera receptora del comercio.
2. Conecta la billetera del cliente. Tu aplicación solicita la conexión de una billetera cripto compatible.
3. Calcula el pago. La función previewPayment() del contrato inteligente devuelve la comisión de procesamiento y el monto que debe pagar el cliente.
4. Solicita el pago. El cliente revisa y firma la transacción. Los pagos con tokens como USDT pueden requerir antes una aprobación aparte.
5. Se procesa la transacción. El contrato inteligente transfiere los fondos a tu billetera y cobra la comisión de procesamiento.
6. Registra la transacción. Tu aplicación guarda el hash de la transacción (txid) y lo asocia al pedido.
7. Verifica el pago. Tu backend comprueba la transacción por su cuenta: estado, red, contrato, activo, destinatario, monto y finalidad en la blockchain.
8. Completa el pedido. Cuando la verificación es correcta, tu aplicación marca el pedido como pagado y lo entrega una sola vez.

Importante: un hash de transacción, una aprobación en la billetera o un estado de transacción exitoso no confirman por sí solos que un pedido esté pagado. Verifica siempre los datos del pago en tu backend antes de entregar un pedido.

Elige tu red

Elige la guía de integración según las redes y los activos que quieras aceptar.

Red	Activos en estas guías	Billeteras de clientes	Guía de integración
Ethereum y BNB Smart Chain	ETH, BNB, USDT (ERC-20 y BEP-20)	MetaMask y billeteras compatibles con WalletConnect	Integración EVM
TRON	TRX, USDT (TRC-20)	TronLink; WalletConnect mediante una integración aparte	Integración TRON

Otras redes y activos pueden requerir implementaciones aparte. Consulta Aceptar pagos cripto no custodiales para ver una descripción general del producto y las opciones disponibles.

Antes de empezar

Necesitarás:

• Billetera del comercio: una billetera cripto que controles para recibir los pagos.
• Aplicación: un sitio web o una aplicación con interfaz de pago.
• Backend y base de datos: para crear pedidos, guardar los datos de las transacciones y verificar los pagos.
• Integración de billeteras: una biblioteca de conexión de billeteras compatible con la red elegida.
• Datos del contrato inteligente: las direcciones de los contratos procesadores, la ABI y los parámetros que proporciona Volet.com.
• Acceso a la blockchain: un proveedor RPC o un servicio blockchain alojado para verificar las transacciones.

Según tu integración, también puedes necesitar un Project ID de WalletConnect o una clave de API de TronGrid.

Contacta a nuestro equipo para obtener los datos del contrato inteligente y hablar de tu integración.

Comisiones de procesamiento

El contrato inteligente calcula la comisión de procesamiento con previewPayment(). Tu aplicación elige quién la paga:

• Paga el cliente: la comisión se suma al monto del pago. El comercio recibe el monto solicitado.
• Paga el comercio: la comisión se descuenta del monto solicitado. El comercio recibe el resto.

Las comisiones de red de la blockchain, como el gas en Ethereum o los costos de Energy y Bandwidth en TRON, son independientes de la comisión de procesamiento de Volet.com.

Usa siempre los montos que devuelve previewPayment() en lugar de calcular la comisión manualmente.

Los parámetros del contrato y el cálculo de la comisión se describen en la Referencia de contratos inteligentes.

Guías de integración

Sigue estos pasos para completar tu integración:

1. Implementa el flujo de pago. Usa la guía de Ethereum y BNB Smart Chain o la guía de TRON para conectar las billeteras de los clientes, configurar los contratos inteligentes y enviar los pagos.
2. Implementa la verificación de pagos. Sigue Verificación de pagos y seguimiento de pedidos para asociar las transacciones de la blockchain con los pedidos y evitar entregas duplicadas.
3. Prueba tu integración. Antes del lanzamiento, prueba pagos exitosos y fallidos, aprobaciones de tokens, transacciones rechazadas y la verificación de pagos.

Recursos adicionales:

• Referencia de contratos inteligentes: direcciones de los procesadores, decimales de los tokens, funciones y parámetros de los contratos.
• Solución de problemas: errores frecuentes de billeteras, transacciones y contratos.

Ejemplos de integración

Las guías de cada red incluyen ejemplos en HTML que puedes abrir en el navegador o descargar:

• Ejemplo EVM (example-evm.html): conexión de billeteras, cálculo de comisiones, pagos en ETH, BNB y USDT, y seguimiento de transacciones.
• Ejemplo TRON (example-tron.html): conexión de TronLink, cálculo de comisiones, pagos en TRX y USDT, y seguimiento de transacciones.

Cada guía explica cómo usar su ejemplo.

Importante: ambos ejemplos usan contratos en mainnet. Cualquier pago que confirmes en tu billetera mueve fondos reales. Para probar pagos necesitas dos billeteras: una para enviar los fondos y otra para recibirlos.

Limitaciones de la demo: los ejemplos guardan el historial de transacciones en el localStorage del navegador. No incluyen un backend de producción ni una verificación completa de los pagos. Adáptalos y pruébalos antes de aceptar pagos reales de clientes.

Integra con un asistente de programación con IA

Un asistente de programación con IA puede ayudarte a integrar los pagos con contratos inteligentes de Volet.com en tu aplicación.

Usa nuestro prompt de integración listo para usar, que cubre la conexión de billeteras, el procesamiento de pagos, la verificación en el backend, el seguimiento de pedidos y las pruebas.

Dale a tu asistente de IA el prompt, el código fuente de tu aplicación y las guías de integración correspondientes.

Importante: revisa y prueba todo el código generado por IA antes de procesar pagos reales. Verifica las direcciones de los contratos, la lógica de validación de pagos y el manejo de las transacciones.

Relacionado

• Aceptar pagos cripto no custodiales: conoce cómo funciona la aceptación de pagos no custodiales y sus características.