Podés configurar los webhook endpoints a través del API para ser notificado por cada uno de los eventos que ocurran y te sean de interés. Entre ellos, encontrarás notificaciones relacionadas a cambios de estado de órdenes, depósitos y retiros.

Existen dos tipos de compañía. PARTIALLY_MANAGED y FULLY_MANAGED.

FULLY_MANAGED

En este tipo la empresa no llevará un registro de los saldos de sus clientes ni de las operaciones bancarias, y no se permite deuda. El saldo final del usuario será 100% el saldo en Manteca. Las órdenes siempre utilizarán el saldo del cliente, sin generar deuda. Para ingresar saldos a la plataforma el cliente debe hacer un depósito y para retirar saldos el cliente debe hacer un retiro. Las ganancias se registran como un crédito especial que debe liquidarse por Manteca en un intervalo de tiempo específico acordado con la empresa.

PARTIALLY_MANAGED

Este tipo está diseñado pensando en los Proveedores de Servicios de Pago (PSP). La empresa llevará un registro de al menos uno de los fiat (ARS, USD o ambos), y las operaciones se realizarán contra la deuda. La empresa gestiona el saldo de la moneda(s) asociadas. Manteca, por su parte, se encargará de gestionar el balance de la moneda no gestionada por la empresa, así como los activos de mercado asociados. Las órdenes contra la moneda manejada por la empresa siempre generarán deuda, sin utilizar el saldo del cliente. El resultado de la orden siempre aumentará el saldo del cliente, sin generar crédito. En caso de que sea la moneda manejada ésta se retira automáticamente apenas el mercado lo permita. Los depósitos de la moneda manejada siempre generarán crédito, sin aumentar el saldo del cliente. Se prohíben los retiros fiat de la moneda manejada y se realizan automáticamente al final del día, utilizando el saldo del cliente, sin generar deuda. Se permiten los retiros de las monedas no manejadas, utilizando el saldo del cliente, sin generar deuda. Las ganancias se registran como un crédito especial que debe liquidarse por Manteca en un intervalo de tiempo específico acordado con la empresa.

Se puede llegar a requerir una inversión inicial que consideramos reserva para proveer liquidez. La empresa tendrá un límite determinado en dólares que indicará cuánta deuda puede llegar a tener en el momento. Para aumentar el límite se puede otorgar más reservas de antemano. Cada cierto período se realizarán dos tipos de settlements. El primero, retiro de ganancias, donde Manteca enviará las ganancias a la compañía. El segundo, balancear la deuda contra el crédito de la empresa o Manteca y dejar registro del total operado durante ese ciclo. De ser necesario se harán transferencias entre la empresa y Manteca. La frecuencia de ambos settlements son independientes, pueden ocurrir en plazos determinados arbitrariamente.

Para altas de un cliente, Manteca asume que el email del cliente está verificado. El cliente se compone por dos módulos, la persona y el usuario.

Usuario

El usuario es la cuenta del cliente para la compañía. Se identifica con su número de cuenta (numberId).

Persona

Contiene los datos personales del cliente que se comparten entre todas las compañías. Esto permite que un cliente puede pertenecer a dos o más compañías sin conflicto. Se identifica con su número de ID nacional (legalId. Acepta CUIT, CUIL o pasaporte).

Conflicto de Persona

Al dar de alta un cliente, la empresa otorgará los datos de la pesona del mismo. Si el individuo tuviese una persona registrada, se comparará los datos nuevos recibidos con los datos existentes. Si existe una diferencia entre los datos, se generará un conflicto. En este paso, se requiere intervención de un administrador de Manteca, el cual actualizará la persona con los datos más recientes.

Flujo de Onboarding

Empieza el alta con el endpoint de Onboarding inicial. Recibe email, legalId, personalData (datos personales simplificados, no todo. El resto se intentará obtener directamente de servicios de información como AFIP) e información de bancos. En la response, en caso de obtener la flag de causedConflict: True se debe esperar a que un administrador lo resuelva.

Se debe ver el status del usuario creado. Dependiendo del status del usuario, faltará cierta información:

• si status es EMAIL_VALIDATED requiere más información de la persona. (Utilizar endpoint de modificar persona para completar)
  • Asegurar de que existan todos estos datos phoneNumber, name, surname, sex, birthDate, nationality, maritalStatus, work, address.street, IVA, ganancias
• si status es PERSONAL_DATA_COMPLETE requiere información bancaria. (Utilizar endpoint de modificar usuario para completar)
• si status es USER_DATA_COMPLETE requiere subir DNIs (Ver sección de suba de DNIs)
• si status es VALIDATING requiere esperar.
• si status es VALIDATION_FAILED requiere resubir la documentación ya que fue rechazada.
• si status es VALIDATED u ONBOARDING_FAILED requiere esperar a que un administrador de Manteca solucione el alta.
• si status es ACTIVE el cliente está disponible para operar.

Para depositar balance en la cuenta de un cliente, el cliente debe hacer una transferencia bancaria con una cuenta bancaria a nombre del cliente (Mismo CUIT/CUIL). Si un cliente tiene usuarios con dos compañías, se requiere intervención de un administrador de Manteca para que asigne el depósito a la compañía correspondiente.