Services for PSPs
For companies registered with the BCRA as a PSP (Proveedor de Servicios de Pago) that want their customers' balances to earn a return in an Allaria mutual fund.
If your company is not a PSP, nothing here applies to you.
The shape of the integration: your customers' accounts live inside a range of account numbers Allaria assigned to you. For accounts in that range, you:
- submit subscriptions and redemptions in batches;
- read back holdings, quotes and daily totals.
When your integration is set up, Allaria reserves a contiguous block of account numbers for you. Every account you operate through these endpoints has to be inside it.
- An account number outside your range comes back as an error entry in the response, not as a request-level failure — check the per-account entries, not just the status code.
- Your PSP identity comes from your access token, so no endpoint takes a PSP id in the path or the body.
The flow
- Get fund quote — the current price of a fund enabled for you. You need it to tell a customer what they will get.
- Send funds requests — the core call. Submits a batch of subscriptions and redemptions: the fund, the currency, and the list of accounts with their amounts.
- List account operations — what was submitted on a given date, optionally filtered by account. Use it to confirm what went through.
- Get account holdings valuation — what a batch of accounts currently holds and what it is worth. Cached, so it is cheap to call for many accounts.
- Get daily summary — the day's totals by operation type, for reconciliation at close.
Steps 1 and 2 are the write path; 3, 4 and 5 are how you reconcile.
Paths are in Spanish here
Send these paths exactly as documented: /v1/psp/fondos/{fondo}/cotizacion, /v1/psp/tenencia-val. They are the real paths — the service behind them has its routes in Spanish, so the paths and one path parameter are too.
fondo means fund and cotizacion means quote; see the Glossary.
Common failure modes
| Symptom | Cause |
|---|---|
Some accounts come back as error entries, 200 overall | Those account numbers are outside your assigned range, or do not exist |
403 on every endpoint here | Your credentials are not authorized as a PSP — contact integraciones@allaria.com.ar |
| A fund is rejected | That fund is not enabled for your integration. get-fund-quote only returns the ones that are |
| Request times out with no status code | Your IP is not whitelisted — see Access |