Saltar al contenido principal

Subcomercios

Acepta pagos en nombre de varios comercios con una sola integración de Volet.com.

La compatibilidad con subcomercios permite que las plataformas creen sus propios productos de pago sobre Volet.com. En lugar de dar de alta a cada comercio directamente en Volet.com, la plataforma se integra una sola vez y procesa pagos en nombre de sus propios comercios.

Los clientes siguen pagando a través de tu plataforma o de tus subcomercios, mientras tu plataforma sigue siendo el único punto de integración con Volet.com.

Cada pago se puede asociar a un subcomercio concreto, lo que permite a la plataforma identificar el pago, seguir los pedidos y gestionar la liquidación según su propia lógica de negocio.

Casos de uso habituales:

  • Proveedores de pagos de marca blanca
  • Agregadores de comercios
  • Marketplaces
  • Plataformas para creadores
  • Plataformas SaaS que atienden a varios comercios

Cómo funciona​

Una plataforma se integra una sola vez con Volet.com y acepta pagos en nombre de varios subcomercios.

El flujo de pago general:

  1. Tu plataforma crea una solicitud de pago en nombre de un subcomercio.
  2. Tu plataforma incluye la información del subcomercio en la solicitud de pago.
  3. El cliente completa el pago a través de Hosted Checkout, tu propia interfaz de pago basada en la API o un flujo con contrato inteligente.
  4. Los fondos se reciben según el modelo de pago elegido.
  5. Tu plataforma vincula el pago completado con el pedido del subcomercio correspondiente.
  6. Tu plataforma liquida los fondos con el subcomercio según sus propias condiciones comerciales.

Modelos de integración​

La compatibilidad con subcomercios está disponible con distintos modelos de integración.

Hosted Checkout​

Hosted Checkout ofrece una experiencia de pago lista para usar y permite que tu plataforma asocie cada pago a un subcomercio concreto.

Al crear una solicitud de pago de Hosted Checkout, puedes enviar el sitio web del subcomercio en el parámetro ac_submerchant_url.

Ejemplo:

<input type="hidden" name="ac_submerchant_url" value="https://seller.example.com">

También puedes incluir campos personalizados, por ejemplo:

  • ID del subcomercio
  • ID del vendedor
  • ID del pedido en el marketplace
  • Número de factura interno
  • ID del cliente

Estos valores se devuelven sin cambios en las notificaciones de estado y en las redirecciones del cliente, lo que permite a tu plataforma asociar los pagos completados con el subcomercio y el pedido correctos.

Consulta Integración de Hosted Checkout para más detalles.

API con Hosted Checkout​

La API y Hosted Checkout se pueden combinar en un mismo flujo de pago.

La API se encarga de crear la factura de pago, mientras que Hosted Checkout ofrece la interfaz de pago para el cliente.

En este modelo, tu plataforma crea una factura cripto mediante la API y la asocia a un pedido del subcomercio antes de redirigir al cliente a Hosted Checkout.

A diferencia del flujo estándar de Hosted Checkout, la factura de pago la crea tu plataforma y no Hosted Checkout. Hosted Checkout solo muestra la página de pago de la factura existente y gestiona la experiencia de pago del cliente.

Este enfoque permite que tu plataforma:

  • Asocie el pago a un subcomercio antes de que el cliente empiece a pagar.
  • Mantenga su propia lógica de gestión de pedidos y facturas.
  • Evite crear y mantener una interfaz de pago propia o para sus subcomercios.
  • Deje que Volet.com se encargue de las instrucciones de pago, los códigos QR, el monitoreo de la blockchain y las actualizaciones de estado del pago.

Sin Hosted Checkout, el mismo flujo puede implementarse íntegramente con la API. En ese caso, tu plataforma o cada subcomercio debe ofrecer su propia interfaz de pago a los clientes.

Cuando se completa el pago, tu plataforma recibe o consulta el estado del pago y lo vincula con el subcomercio correspondiente mediante la referencia de la factura o del pedido.

Consulta:

Pagos con contratos inteligentes​

Las plataformas también pueden admitir subcomercios con pagos no custodiales mediante contratos inteligentes.

En este modelo, los clientes pagan directamente desde sus billeteras y el pago lo ejecuta en la blockchain un contrato inteligente.

A diferencia de los flujos custodiales, la lógica de liquidación se puede implementar directamente en el contrato inteligente. Por ejemplo, cada pago se puede dividir automáticamente entre la plataforma y uno o varios subcomercios en el momento en que se ejecuta.

Casos de uso habituales:

  • Reparto de ingresos
  • Distribución de comisiones en marketplaces
  • Pagos a varios destinatarios
  • Liquidación directa de billetera a billetera
  • Lógica de pago personalizada

Consulta Reparto de ingresos para más detalles.

Seguimiento de los pagos de subcomercios​

Asocia cada pago con tus propios identificadores para poder vincularlo con el subcomercio y el pedido correspondientes.

Identificadores habituales:

  • ID del subcomercio
  • Sitio web del subcomercio
  • ID del pedido en el marketplace
  • ID de factura interno
  • ID del cliente
  • ID del lote de liquidación

Con Hosted Checkout, puedes usar el parámetro ac_submerchant_url y campos personalizados.

En los flujos de facturas cripto por API, guarda el ID de la factura cripto junto con el pedido de tu plataforma y el registro del subcomercio.

En los flujos con contratos inteligentes, tu aplicación puede usar metadatos de la transacción, referencias de pedidos o eventos en la blockchain, según la arquitectura de contrato inteligente elegida.

Liquidación a los subcomercios​

En los flujos de pago custodiales, los fondos recibidos se acreditan en la cuenta de Volet.com del comercio principal.

Una vez completado el pago, el comercio principal es responsable de liquidar con el subcomercio según su propio modelo comercial.

Puedes liquidar con los subcomercios mediante uno de estos métodos:

  • Transferir criptomonedas a una billetera cripto.
  • Transferir fondos a la cuenta de Volet.com del subcomercio.
  • Enviar una transferencia bancaria manualmente desde la interfaz de la cuenta, donde esté disponible.
nota

Por ahora, las transferencias bancarias a subcomercios no están disponibles por la API. Si necesitas liquidar por transferencia bancaria, debes hacerlo manualmente desde la interfaz de la cuenta.

Tu plataforma también puede descontar su propia comisión antes de liquidar el monto restante al subcomercio.

Por ejemplo:

  1. El cliente paga 100 USDT.
  2. Tu plataforma recibe el pago.
  3. Tu plataforma se queda con una comisión de 10 USDT.
  4. Tu plataforma liquida 90 USDT al subcomercio.

Cumplimiento y revisión​

El procesamiento para subcomercios está sujeto a revisión.

Tu plataforma es responsable de saber quiénes son sus subcomercios, qué bienes o servicios ofrecen y si su actividad está permitida por las políticas de Volet.com.

nota

Todos los requisitos de cumplimiento, actividades prohibidas y verificación que se aplican a los comercios también se aplican a los subcomercios.

Volet.com puede pedir información sobre tu modelo de subcomercios, el proceso de alta, las categorías de negocio, los sitios web, los flujos de transacciones y la lógica de liquidación antes de habilitar o aprobar la integración.

Cómo activarlo​

Paso 1. Contáctanos​

El procesamiento para subcomercios se configura de forma individual. Agenda una llamada con nuestro equipo de ventas.

Contacta a nuestro equipo y describe:

  • El modelo de tu plataforma
  • Los tipos de subcomercios que atiendes
  • Los métodos de pago previstos
  • El flujo de liquidación previsto

Nuestro equipo te ayudará a elegir el modelo adecuado:

  • Hosted Checkout, para una experiencia de pago lista para usar.
  • API con Hosted Checkout, para facturas cripto creadas de antemano y la interfaz de pago de Hosted Checkout.
  • Integración solo por API, si tu plataforma ofrece su propia interfaz de pago.
  • Contratos inteligentes, para flujos no custodiales y lógica de liquidación personalizada en la blockchain.

Paso 2. Configura la aceptación de pagos​

Si usas Hosted Checkout, la API o la API con Hosted Checkout, crea y configura una pasarela de pago en tu cuenta de Volet.com.

La pasarela define cómo se aceptan los pagos, qué métodos de pago están activados y cómo se gestiona la información de estado de los pagos.

Consulta:

Si usas un flujo de pago con contrato inteligente, nuestro equipo te proporcionará la configuración del contrato necesaria.

Paso 3. Implementa la integración​

Implementa el flujo de pago que corresponde al modelo de integración elegido.

Para los detalles de implementación, consulta:

Paso 4. Configura los datos de los subcomercios y la vinculación de pedidos​

Define cómo tu plataforma enviará, guardará y vinculará la información de los subcomercios.

Paso 5. Prueba los flujos de pago y liquidación​

Antes de pasar a producción, prueba:

  • La creación de pagos
  • La identificación de subcomercios
  • La gestión del estado de los pagos
  • La vinculación de pedidos
  • El cálculo de comisiones
  • La liquidación a subcomercios
  • Los escenarios de pagos fallidos y cancelados

Paso 6. Pasa a producción​

Una vez aprobada, configurada y probada la integración, tu plataforma puede empezar a aceptar pagos en nombre de sus subcomercios.

Limitaciones​

  • Tu plataforma es responsable de liquidar con el subcomercio.
  • La liquidación por transferencia bancaria a subcomercios no está disponible por la API.
  • Algunos modelos de negocio de subcomercios pueden requerir una revisión de cumplimiento adicional antes de la activación.