Desarrolladores
Split de Pagos
5 min
la siguiente documentación indica como crear un split de pagos dividiendo la operación en diferentes entidades modulos soportados boton de pago https //ayuda unicobros com ar/irpd3rjz0 qkzvfqxeo2f link de pagos https //ayuda unicobros com ar/link de pago suscripciones https //ayuda unicobros com ar/suscripciones 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 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 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 //unicobros com/sale/return?session=56789", "webhook" "https //unicobros com/sale/webhook?user=1234", "split" \[ { "entity" "h1rjexyr", "total" 799, "reference" "pago 1", "fee" 100 }, { "entity" "j7rbxl5si", "total" 201, "reference" "pago 2", "fee" 80 } ] } respuesta en la respuesta unicobros pre generará los identificadores de transacción de las transacciones hijas de la operación distribuida deberá almacenar estos uid de forma segura { "split" \[ { "uid" "chd efpi58c4pfmg4gqx8x", "total" 799, "reference" "pago 1", "fee" 100 }, { "uid" "chd efpi58c4pfmg4gqx8x", "tax id" "33213213216", "total" 201, "reference" "pago 2", "fee" 80 } ] }