Marketplace y Multivendor

Marketplace

5min

Es un sitio web E-commerce donde intervienen múltiples vendedores ofreciendo sus productos.

El dueño del marketplace, "originante" genera una comisión por cada compra y el resto del pago va hacia los vendedores que intervengan en esa operación.

Parámetro "split"

El parámetro split deberá ser un Array de objetos JSON ( Hasta 50 ) que contendrá los Comercios entre las cuales se dividirá el pago total solicitado.

  • entity: ID único del comercio.
  • total: Monto total a ser pagado a la Empresa a la cual va dirigido el pago. Formato XXX.xx donde el PUNTO es el separador decimal.
  • fee: Monto de la comisión que cobrará el creador del pago. El receptor de la comisión será la Empresa que genera la operación. Formato XXX.xx donde el PUNTO es el separador decimal.
  • hold: Indica si el dinero correspondiente a la parte dividida será retenido. Tenga en cuenta que un pago retenido deberá ser liberado via API (sólo válido para clientes Fresa). Valores: true/false
  • description: Descripción de la operación hija.
  • reference: Identificación del cupón de la Operación.
  • refundFee: Indica si la comisión desea ser devuelta en caso de devoluciones totales. Valores: true/false. Por defecto: true
    

Importante:

  • Al crear una operación con Split se validará que el monto separado entre las diferentes entidades coincida con el monto solicitado en el Checkout. Ej. Si solicita generar un cobro por $ 1000 e intenta separar el Pago entre la Empresa A por $ 600 y la Empresa B por $ 100 el mismo no podrá ser generado y resultará en un error debido a que el total de la división es $ 700 en vez de los $ 1000 solicitados.
  • Recuerde que el fee será transferido a la empresa creadora de la operación.
  • Todos los montos expresados son totales y no porcentajes.

La empresa creadora de la operación contendrá la "Operación Padre", mientras que cada uno de los comercios a los cuáles se hace un split de la operación contendrá una "Operación Hija". Se define el siguiente diagrama de flujo como ejemplo de esta operatoria:

Definición de una operación en modalidad Split
Definición de una operación en modalidad Split


Ejemplo: Creación de Checkout con Split

Cuando se crea un Checkout con Split se debe enviar un Array adicional con los elementos antes mencionados usando JSON en el Body de la solicitud al servicio.

JSON


Respuesta

En la respuesta Mobbex pre-generará los identificadores de transacción de las transacciones hijas de la operación distribuida. Deberá almacenar estos UID de forma segura. Además si está generando una retención de dinero durante la operación estos UID le permitirán generar la liberación de fondos.

JSON

Mediante este llamado a nuestro API podrás procesar la liberación de los fondos retenidos durante una operación de tipo Split.
GET
Request
Query Parameters
ID
optional
String
ID de la Operación que se intenta liberar.
Header Parameters
x-api-key
optional
String
Clave API de su aplicación.
x-access-token
optional
String
Token de Acceso de la entidad.