Marketplace y Split de pagos

Modalidades

• Split: la operatoria Split sólo se llevará a cabo entre comercios de tipo Ready.
• Distribuido: la operatoria Distribuida se da en los casos donde todos los comercios involucrados son de tipo Direct. Este tipo de operatoria se da a nivel Marca y la complejidad es mayor a la encontrada en Split.

Importante

Todos los comercios entre los cuales se planea dividir una operación deben existir en Mobbex ya sean Ready o Direct. Esto se debe a que la operación debe ser trazable en todo momento y el comercio involucrado debe ser capaz de realizar las acciones necesarias sobre los fondos que le son atribuídos.

Para conectar comercios Ready a Mobbex generando el alta si los mismos no existen, ver Mobbex Connect

Módulos Soportados

• Checkout
• Suscripciones
• Órdenes de Pago

Parámetro "split"

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

• tax_id: Identificación tributaria de la Empresa a la cual va dirigido el pago. En Argentina colocar el CUIT sin guiones ni puntos.
• 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.

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



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.

{
    "total": 1000,
    "currency": "ars",
    "reference": "12345",
    "description": "Descripción de la Venta",
    "return_url": "https://mobbex.com/sale/return?session=56789",
    "webhook": "https://mobbex.com/sale/webhook?user=1234",
    "split": [
        {
            "tax_id": "30121231235",
            "total": 799,
            "reference": "pago_1",
            "fee": 100
        },
        {
            "tax_id": "33213213216",
            "total": 201,
            "reference": "pago_2",
            "fee": 80
        }
    ]
}

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.

{
    ...
    "split": [
        {
      "uid": "CHD-EFPI58C4PFMG4GQX8X",
            "total": 799,
            "reference": "pago_1",
            "fee": 100
        },
        {
      "uid": "CHD-EFPI58C4PFMG4GQX8X",
            "tax_id": "33213213216",
            "total": 201,
            "reference": "pago_2",
            "fee": 80
        }
    ]
}