Saltar al contenido principal

Crear una pasarela de pago

Para usar las pasarelas de pago custodiales, necesitas una cuenta de Volet.com verificada. Si todavía no tienes una, consulta Crear una cuenta, Verificación de empresa o Verificación personal.

Las integraciones de pago no custodiales no requieren una cuenta de Volet.com. Contacta a nuestro equipo para conocer los detalles de la integración.

Elige el método de integración​

  • Usa Hosted Checkout si quieres la integración más rápida, con una página de pago lista alojada por Volet.com. También es el único método de integración que admite pagos desde el saldo de cuentas de Volet.com.
  • Usa la API si quieres crear tu propio flujo de pago y controlar por completo la experiencia del cliente.

Compara API, Hosted Checkout y contratos inteligentes para elegir el método de integración adecuado para tu negocio.

nota

Puedes cambiar esta configuración en cualquier momento después de crear la pasarela.

Opción 1: crear una pasarela Hosted Checkout​

Paso 1: crear un Hosted Checkout​

Inicia sesión en tu panel de Volet.com, ve a Herramientas de pago y haz clic en Crear en la sección Hosted Checkout.

Paso 2: configurar los métodos de pago​

En la primera pestaña, activa los métodos de pago que quieres aceptar:

MétodoDescripción
Usuarios de Volet.comLos clientes pagan desde su cuenta de Volet.com.
Billeteras criptoLos clientes pagan en BTC, ETH, USDT, USDC y otros tokens compatibles desde cualquier billetera cripto.

Más sobre cada método:

Para cada método, configura Quién paga la comisión: indica si la comisión de procesamiento se descuenta del monto recibido (Paga el comercio) o se suma al monto que paga el cliente (Paga el comprador).

Paso 3: configurar los ajustes​

Configura la página de Hosted Checkout y las URL de callback.

Opciones de procesamiento de pagos​

  1. Usar firma digital en las solicitudes de Hosted Checkout.

    Firma las solicitudes de pago y las notificaciones de callback con tu contraseña de Hosted Checkout. Así puedes verificar que las solicitudes provienen de Volet.com y que no se modificaron durante la transmisión.

    Recomendamos mantener esta opción activada en producción.

  2. Aceptar pagos insuficientes.

    Permite completar pedidos cuando el cliente envía menos del monto solicitado.

    Puede ser útil en pagos con criptomonedas, donde las comisiones de red, los cálculos manuales o las variaciones del tipo de cambio pueden dar como resultado un pago algo menor al esperado.

  3. Aceptar pagos en exceso.

    Permite completar pedidos cuando el cliente envía más del monto solicitado.

    Puede ser útil cuando los clientes transfieren por error un monto mayor al solicitado.

Configuración de Hosted Checkout​

  1. Nombre del Hosted Checkout. Nombre que identifica este Hosted Checkout dentro de tu cuenta de Volet.com.

  2. URL del sitio web, la app móvil, el bot o el agente de IA. Indica la URL pública asociada a esta pasarela de pago. Esta URL también se muestra a los clientes durante el pago.

Ejemplos:

  1. Email de notificaciones. Dirección de email opcional que recibe notificaciones sobre las transacciones procesadas con esta configuración de Hosted Checkout.

  2. Email que se muestra en Hosted Checkout. Reservado para uso futuro.

  3. Contraseña de Hosted Checkout. Clave secreta que se usa para firmar las solicitudes de pago y verificar las notificaciones de callback. Mantenla en privado y no la expongas en el código del lado del cliente.

Configuración de las URL de estado​

Luego configura las URL de callback y de redirección. Puedes omitir estos parámetros o indicarlos en el formulario de solicitud de pago.

  1. Success URL. URL a la que se redirige a los clientes después de un pago exitoso.

  2. Failed URL. URL a la que se redirige a los clientes si el pago falla o se cancela.

  3. Status URL. Endpoint de tu servidor que recibe las notificaciones de estado de los pagos. Úsalas para actualizar automáticamente el estado de los pedidos en tu sistema.

Para Success URL, Failed URL y Status URL puedes elegir el método HTTP:

  • GET: los parámetros se envían en la query string.
  • POST: los parámetros se envían en el cuerpo de la solicitud.

Paso 4: personalizar la apariencia (opcional)​

Opcional; puedes configurarlo más adelante.

Puedes personalizar la página de Hosted Checkout con tu logotipo y los colores de tu marca.

Paso 5: aprobación​

Las pasarelas recién creadas requieren la aprobación de un administrador antes de poder aceptar pagos reales.

La aprobación suele tardar unas horas.

Recibirás una notificación por email cuando tu pasarela esté aprobada y lista para usar.

nota

No puedes procesar pagos reales hasta que se apruebe la pasarela. Aprovecha ese tiempo para completar la integración en tu sitio.

Paso 6: integrar Hosted Checkout​

Una vez aprobada, puedes integrar Hosted Checkout en tu sitio web, aplicación, bot o agente de IA.

Consulta: Integración de Hosted Checkout

Opción 2: crear una pasarela API​

Paso 1: crear una pasarela API​

Inicia sesión en tu panel de Volet.com, ve a Herramientas de pago y haz clic en Crear en la sección API.

Paso 2: configurar los ajustes de la API​

Configura los ajustes básicos de la API.

  1. Nombre de la API. Nombre interno de la pasarela API. Solo se usa dentro de tu cuenta de Volet.com.

  2. Lista blanca de IP. Lista de direcciones IP con acceso a la API.

    Puedes:

    • Ingresar una o varias direcciones IP manualmente.
    • Hacer clic en Agregar IP actual para agregar automáticamente tu dirección IP actual.
    • Activar Permitir todas las IP para desactivar las restricciones por IP (no recomendado en producción).

  3. Contraseña de la API. Clave secreta que se usa para autenticar las solicitudes a la API. Mantenla en privado y no la expongas en el código del lado del cliente.

  4. URL del sitio web, la app móvil, el bot o el agente de IA. Indica la URL pública asociada a esta integración por API.

Ejemplos:

  1. Email de notificaciones. Dirección de email opcional que recibe notificaciones sobre las transacciones procesadas con esta pasarela API.

Paso 3: configurar los permisos de la API​

Elige qué permisos estarán disponibles para esta pasarela API.

Para integraciones de aceptación de pagos, activa:

  • Realizar transacciones
    • Aceptar pagos cripto: permite que tu aplicación cree facturas de pago y acepte pagos con criptomonedas desde billeteras cripto.
  • Buscar transacción: permite que tu aplicación consulte el estado del pago y los detalles de la transacción después de crear una factura.

Las integraciones por API no usan URL de callback. Después de crear una factura, tu aplicación debe usar Buscar transacción para consultar el estado actual del pago.

Más adelante puedes activar permisos adicionales, como la consulta de saldos, el historial de transacciones, los cambios de moneda y los envíos de pagos, si tu integración los necesita. Consulta la referencia de la API para más detalles.

Paso 4: aprobación​

Las pasarelas API recién creadas requieren la aprobación de un administrador antes de poder procesar transacciones reales.

La aprobación suele tardar unas horas.

Recibirás una notificación por email cuando tu pasarela API esté aprobada y lista para usar.

nota

No puedes procesar transacciones reales hasta que se apruebe la pasarela API.

Paso 5: integrar​

Una vez aprobada, puedes empezar a aceptar pagos por la API.

Consulta:

  • Integración por API: guía práctica para integrar una pasarela de pago por API.
  • Referencia de la API: documentación completa de métodos, parámetros y respuestas.