Integración via API

Mediante esta integración, podrás consumir distintos recursos para obtener la información que precises.

Payments#

Esta api te da toda la información de los pagos que las procesadoras te hicieron, es decir, las liquidaciones. Dentro de cada payment, podrás filtrar para obtener o no el detalle de los movimientos (movements) que lo componen. Ver API request

Movements#

Esta api te da toda la información de los movimientos (movements) que componen una liquidación, es decir, el detalle de las transacciones, deducciones y contracargos. Ver API request

Taxes#

Esta api te da toda la información de los impuestos que detalla una liquidación. Ver API request

Prácticas recomendadas#

Si vas a automatizar la búsqueda de payments, siempre te recomendamos hacerlo buscando todos los días por fecha de creación el día anterior. Esta es la única forma de asegurarte no perder nunca una liquidación, ya que podríamos encontrar y crear nuevas liquidaciones de una fecha de pago luego de que hayas realizado el request y de otra forma, podrías perderlas. Por ejemplo, si en algún momento agregases un nuevo número de establecimiento en Increase, nosotros iremos a buscar todas las liquidaciones que existan en la procesadora en ese momento, independientemente de su fecha, y crearemos todos los payments en Increase con fecha de creación del día que los busquemos.

Importante! Puede suceder que haya alguna novedad del payment y sea reprocesado y corregido en Increase. Tu integración deberá ser capaz de actualizar tus registros y siempre estar al día con la información. Para hacer esto, debes tener en cuenta la versión del payment que estás obteniendo.

Si una liquidación es reprocesada en Increase y sufre alguna modificación, eso implicará que se cree un nuevo payment ID, con su correspondiente fecha de creación, pero con una versión diferente a 1. Cuando hagas la búsqueda por fecha de creación, dentro de los resultados verás un pago con versión mayor a “1”. Eso significa que probablemente ese pago ya lo tienes registrado en tu sistema. Deberás validar por los siguientes 4 campos si ese payment ya lo tienes:

  • Clearing_number
  • Payment_date
  • Provider
  • Nro de establecimiento

Si efectivamente tienes ese payment en tu sistema, impactas las novedades. Si no lo tienes, entonces lo registras. Puede pasar que se haya creado y modificado la versión del payment antes de que realices el request. Entonces si bien el payment es la primera vez que lo registras, no tiene versión “1”.

Control de balanceo de la API#

Increase valida que la clearing esté balanceada comparando los siguientes puntos:

  1. Suma del monto de las transacciones (movements) = total_amount
  2. Suma de descuentos (movements) = total_deduction
  3. Total presentado - Total descontado = total_earn

En el campo “is_balanced” podrás validar si una liquidación cumple con estos 3 puntos o no. En caso de que la liquidación no esté balanceada, te indicaremos también el monto de diferencia de cada motivo. Esto te permitirá tomar una decisión con respecto a dicho payment.