Agregadores y PSPaaS
Liquidaciones
Webhook Liquidación
3 min
el webhook o callback de liquidación le permitirá al agrupador realizar la liquidación en línea de las operaciones de sub comercios las condiciones técnicas que deberá cumplir este tipo de webhook son las mismas que un webhook de operaciones campo descripción type tipo de webhook procesado data información general de la intención de liquidación data devicedata indica la terminal física con la que se ejecutó el pago data entity información del sub comercio data account información sobre la cuenta configurada por el comercio para la liquidación data payment información completa del cobro realizado y medio de pago data service costo del servicio o paquete utilizado en la operación, junto con los importes de servicio o arancel calculado en base a las reglas definidas y su fecha de acreditación data net monto neto de las transacciones corresponde con las transacciones financieras que aplican para la liquidación en curso data transactions transacciones realizadas en la la liquidación, como cálculo de impuestos, costo de servicio u otros cada tipo de transacción posee una codificación para identificarla data settlement contiene información identificatoria sobre la liquidación enviada solicitud de liquidación { "type" "operator settlement", "data" { "result" true, "devicedata" { "appversion" "0 6 0", "buildnumber" "600", "manufacturer" "ingenico", "model" "dx8000", "os" "android", "serialnumber" "ing 226gcd8h7743" }, "view" { "type" "card" }, "entity" { "uid" "gcynngjwu", "reference" "123456", "name" "wayne, inc", "tax id" "123456789" }, "account" { "type" "arg cbu", "number" "0110000000000000000002" }, "source" { "name" "visa", "type" "card", "reference" "visa galicia" }, "payment" { "context" "plugin value pos\ mobile pos", "id" "pwsbfhh9a", "total" 6705, "source" { "name" "visa galicia", "type" "card", "number" "450799 0010", "reference" "visa galicia", "cardholder" { "name" "bruce wayne" }, "expiration" { "year" "12", "month" "35" }, "installment" { "count" 1, "amount" 0, "reference" "", "description" "1" }, "transaction" { "batchno" "10", "ticketno" "1234", "transactionid" "pwsbfhh9a", "authorizationcode" "1010101010" } }, "status" { "code" "200", "data" {}, "text" "transacción aprobada", "view" "default", "message" "transacción aprobada", "resultcode" 0 }, "created" "2022 05 24t08 26 05 377z", "updated" "2022 05 24t08 26 09 966z", "currency" { "code" "ars", "text" "peso argentino", "locale" "es ar", "symbol" "$" }, "operation" { "type" "payment v2" }, "reference" "576127271", "description" "compra 576127271", "riskanalysis" { "band" "n/a", "level" "n/a" }, "requestedtotal" 6705, "requestedcurrency" { "code" "ars", "text" "peso argentino", "locale" "es ar", "symbol" "$" } }, "customer" { "name" "bruce wayne", "email" "bruce\@wayne com", "phone" "+15555555555", "identification" "12123123" }, "service" { "rule" "223ssthacby", "percentage" 2, // porcentaje de arancel sobre la operacóón "amount" 0, // importe fijo de arancel "total" 35, // total del arancel (porcentaje + fijo) "paymentdate" 1653381736930 // fecha original de pago en formato timestamp }, "net" { "total" 6668, "currency" "ars" }, "transactions" \[ { "uid" "lcvszqdcul", "status" "300", "description" "retención iva", "type" "tax", "currency" { "value" "ars", "label" "peso argentino", "symbol" "$", "locale" "es ar", "hidden" false }, "total" 2, "updated" "2021 11 18t18 02 06 759z", "created" "2021 11 07t03 01 26 804z" }, { "uid" "lc718a91k7", "status" "300", "description" "costo de servicio", "type" "service", "currency" { "value" "ars", "label" "peso argentino", "symbol" "$", "locale" "es ar", "hidden" false }, "total" 35, "updated" "2021 11 18t18 02 06 759z", "created" "2021 11 07t03 01 26 804z" }, { "uid" "ju920kaiua", "status" "300", "description" "pago", "type" "payment", "currency" { "value" "ars", "label" "peso argentino", "symbol" "$", "locale" "es ar", "hidden" false }, "total" 6705, "updated" "2021 11 18t18 02 06 759z", "created" "2021 11 07t03 01 26 804z" } ], "settlement" { "id" "hajusika8192iaki1w", "action" "payment" } } } respuesta de liquidación en el caso de que el agrupador desee indicar cual es el código de liquidación asignado, deberá responder a la notificación de la siguiente forma { "result" true, "data" { "status" "fulfilled", "settlementconfirmationid" "uaiksiao8291" // id de confirmación de liquidación } } valores posibles para el objeto stauts fulfilled la liquidación pudo ser cursada exitosamente fulfillment fail retry la liquidación no pudo ser cursada y se debe reintentar la solicitud de liquidación fulfillment fail not retry la liquidación no pudo ser cursada y no se debe reintentar la solicitud de liquidación en caso de que no se devuelva este cuerpo de respuesta (es decir, sin cuerpo de respuesta), el sistema considerará siempre que la liquidación fue fulfilled validación de respuesta la notificación será tomada como válida si cumple con las siguientes condiciones es respondida con un estado http 200, 201 o 204 si contiene un cuerpo en la respuesta, siempre que la propiedad "result" esté definida como true en cualquier otra condición, la notificación de liquidación será marcada como no procesada o fallida