Servicios para PSPs
Para empresas inscriptas ante el BCRA como PSP (Proveedor de Servicios de Pago) que quieren que los saldos de sus clientes rindan en un fondo común de inversión de Allaria.
Si tu empresa no es un PSP, nada de acá te aplica.
La forma de la integración: las cuentas de tus clientes viven dentro de un rango de números de cuenta que Allaria te asignó. Para las cuentas de ese rango, vos:
- enviás suscripciones y rescates en lotes;
- leés de vuelta tenencias, cotizaciones y totales diarios.
Cuando se da de alta tu integración, Allaria reserva un bloque contiguo de números de cuenta para vos. Toda cuenta que operes por estos endpoints tiene que estar dentro de ese bloque.
- Un número de cuenta fuera de tu rango vuelve como una entrada de error en la respuesta, no como una falla del request — revisá las entradas por cuenta, no solo el status code.
- Tu identidad de PSP sale de tu access token, así que ningún endpoint toma un id de PSP en el path ni en el body.
El flujo
- Cotización de un fondo — el precio actual de un fondo habilitado para vos. Lo necesitás para decirle al cliente qué va a recibir.
- Enviar solicitudes de fondos — la llamada central. Envía un lote de suscripciones y rescates: el fondo, la moneda y la lista de cuentas con sus montos.
- Listar operaciones por cuenta — qué se envió en una fecha dada, con filtro opcional por cuenta. Usalo para confirmar qué pasó.
- Valuación de tenencias — qué tiene hoy un lote de cuentas y cuánto vale. Está cacheado, así que es barato consultarlo para muchas cuentas.
- Resumen diario — los totales del día por tipo de operación, para conciliar al cierre.
Los pasos 1 y 2 son el camino de escritura; 3, 4 y 5 son cómo conciliás.
Acá los paths están en español
Enviá estos paths exactamente como están documentados: /v1/psp/fondos/{fondo}/cotizacion, /v1/psp/tenencia-val. Son los paths reales — el servicio que los sirve tiene sus rutas en español, así que los paths y un path parameter también.
Errores frecuentes
| Síntoma | Causa |
|---|---|
Algunas cuentas vuelven como entradas de error, con 200 general | Esos números de cuenta están fuera de tu rango asignado, o no existen |
403 en todos los endpoints de acá | Tus credenciales no están autorizadas como PSP — contactá a integraciones@allaria.com.ar |
| Se rechaza un fondo | Ese fondo no está habilitado para tu integración. get-fund-quote solo devuelve los que sí |
| El request expira por timeout, sin código de estado | Tu IP no está whitelisteada — ver Acceso |