Marketplace y Split de pagos

8min
Modalidades
Split: la operatoria Split sólo se llevará a cabo entre comercios de tipo Fresa.
Distribuido: la operatoria Distribuida se da en los casos donde todos los comercios involucrados son de tipo Mobbex. 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 Fresa o Mobbex. 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 Fresa 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.
JSON
{
    "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
        }
    ]
}
{
    "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.
JSON
{
    ...
    "split": [
        {
      "uid": "CHD-EFPI58C4PFMG4GQX8X",
            "total": 799,
            "reference": "pago_1",
            "fee": 100
        },
        {
      "uid": "CHD-EFPI58C4PFMG4GQX8X",
            "tax_id": "33213213216",
            "total": 201,
            "reference": "pago_2",
            "fee": 80
        }
    ]
}
{
    ...
    "split": [
        {
      "uid": "CHD-EFPI58C4PFMG4GQX8X",
            "total": 799,
            "reference": "pago_1",
            "fee": 100
        },
        {
      "uid": "CHD-EFPI58C4PFMG4GQX8X",
            "tax_id": "33213213216",
            "total": 201,
            "reference": "pago_2",
            "fee": 80
        }
    ]
}
﻿
Mediante este llamado a nuestro API podrás procesar la liberación de los fondos retenidos durante una operación de tipo Split.
GET
Params
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.
﻿
﻿
Updated 26 Sep 2023
Did this page help you?
Tokenización de Tarjetas y Cuentas Bancarias - Wallet Transparent
E-Commerce