Saltar al contenido principal

Integración con contratos inteligentes

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

  • Tu aplicación
  • Un proveedor de conexión de billeteras
  • El contrato inteligente de pago

El proveedor de conexión de billeteras solo se encarga de conectar la billetera del cliente y solicitar la firma de la transacción. El pago en sí lo ejecuta el contrato inteligente en la blockchain.

consejo

Contacta a nuestro equipo antes de empezar la integración. Te proporcionaremos los datos del contrato inteligente necesarios y la ABI, y te ayudaremos a elegir la arquitectura adecuada para tu aplicación.

Flujo de pago​

  1. El cliente llega a tu página de pago.
  2. El cliente conecta su billetera.
  3. Tu aplicación prepara una transacción de pago.
  4. La transacción se envía a la billetera conectada.
  5. El cliente revisa y firma la transacción.
  6. La billetera difunde la transacción firmada en la blockchain.
  7. El contrato inteligente transfiere los fondos.
  8. La billetera recibe un hash de transacción (txid) y lo devuelve a tu aplicación.
  9. Tu aplicación sigue la transacción hasta que alcanza el estado de confirmación requerido.
  10. Tu sistema marca el pedido como pagado.

Requisitos previos​

Antes de integrar, necesitas:

  • Una aplicación frontend capaz de conectar billeteras cripto.
  • Un backend (recomendado) para crear solicitudes de pago y seguir las transacciones en la blockchain.
  • Los datos del contrato inteligente que proporciona Volet.com.
  • Un proveedor de conexión de billeteras adecuado para las redes blockchain que piensas admitir.

Configuración inicial​

Paso 1. Configura la conexión de billeteras​

Integra un proveedor de conexión de billeteras adecuado para las redes blockchain que piensas admitir.

Opciones habituales:

  • WalletConnect: Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche y otras redes compatibles con EVM.
  • TronLink: Tron.
  • TON Connect: TON.
  • Solana Wallet Adapter: Solana.

Algunos proveedores, como WalletConnect, requieren un Project ID o credenciales de API antes de poder usarlos.

Paso 2. Obtén los datos del contrato inteligente​

Contacta a Volet.com para recibir la dirección del contrato inteligente, la ABI y los parámetros específicos de la integración.

Implementación del flujo de pago​

Paso 1. Conecta la billetera del cliente​

Pide al cliente que conecte una billetera compatible.

Por ejemplo:

  • MetaMask o Trust Wallet mediante WalletConnect.
  • TronLink para Tron.
  • Tonkeeper mediante TON Connect.
  • Phantom o Solflare mediante Solana Wallet Adapter.

Paso 2. Prepara la transacción​

Prepara una solicitud de transacción en tu aplicación.

Normalmente incluye:

  • Dirección de la billetera de destino
  • Monto del pago
  • Token
  • Red blockchain (chainId)
  • ID del pedido
  • Metadatos opcionales

La transacción se puede preparar en el frontend o en el backend.

Paso 3. Solicita la firma de la transacción​

Envía la transacción preparada a la billetera conectada.

Con el chainId indicado, la billetera selecciona automáticamente la red blockchain y el endpoint RPC adecuados.

El cliente revisa los detalles de la transacción.

Si todo es correcto, firma la transacción en su billetera.

Paso 4. Difunde la transacción​

Una vez firmada, la billetera difunde la transacción en la blockchain a través del endpoint RPC adecuado.

Si la red acepta la transacción, la billetera recibe un hash de transacción (txid) y lo devuelve a tu aplicación.

Guarda el hash de la transacción junto con tu pedido.

Paso 5. Verifica las confirmaciones de la transacción​

Monitorea la blockchain con el hash de la transacción hasta que el pago alcance el estado de confirmación requerido.

Cuando la transacción tenga suficientes confirmaciones, marca el pedido como pagado en tu sistema.

Proveedores RPC​

Las billeteras de los clientes seleccionan automáticamente un endpoint RPC según el chainId de la transacción, así que las integraciones básicas no requieren configuración adicional.

Si tu aplicación hace muchas solicitudes a la blockchain (por ejemplo, para monitorear transacciones de pago o consultar datos de la blockchain a gran escala), considera usar:

  • Un proveedor RPC dedicado.
  • Tu propio nodo RPC.

Una infraestructura dedicada ayuda a evitar los límites de solicitudes de los RPC públicos y mejora la fiabilidad con mucha carga.

Próximos pasos​

  • Revisa la referencia del contrato inteligente.
  • Prueba los escenarios de pago exitoso y fallido.
  • Verifica la gestión de las confirmaciones de transacciones.
  • Despliega en producción.