Marketplace y Split de pagos
Todos los comercios entre los cuales se planea dividir una operación deben existir en Mobbex ya sean Fresa o Mobbex gateway.
Para conectar comercios Fresa a Mobbex generando el alta si los mismos no existen, ver Mobbex Connect
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:
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.
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.
