# FlowPay API (v1)

**Canonical:** https://apis.io/apis/bancomat/flowpay-api-v1/  
**Provider:** Bancomat — https://apis.io/providers/bancomat/  
**Base URL:** https://app.flowpay.it/api  
**Documentation:** https://docs.flowpay.it/

FlowPay API (v1) is one of 3 APIs that [Bancomat](https://apis.io/providers/bancomat/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Open Banking, Account Information, Payment Initiation, Invoicing, and Webhook. The published artifact set on APIs.io includes API documentation, an API reference, and an OpenAPI specification.

Production REST API of FlowPay S.r.l., the Bank of Italy-authorised payment institution (AISP/PISP, ref. 36925) that BANCOMAT S.p.A. acquired on 2025-07-22. Tenant-scoped endpoints for account information (AIS consents, accounts, balances, transactions), payment initiation (transfers, bulk and chain payments, hosted checkout sessions), invoices, salaries, pagoPA notices and webhook subscriptions, secured by OAuth 2.0 authorization-code and client-credentials flows with PKCE, PAR and signed request objects. The contract is rendered by ReDoc on docs.flowpay.it from a 59-operation OpenAPI 3.0.3.

## Operations (59)

| Method | Path | Summary |
|---|---|---|
| POST | `/ais` | — |
| GET | `/ais/check-iban/{iban}/{vatCode}` | — |
| GET | `/ais/{aisSessionID}` | — |
| GET | `/banks` | — |
| GET | `/banks/{flowpayID}` | — |
| GET | `/pagopa` | pagoPA list |
| POST | `/pagopa` | pagoPA payment |
| GET | `/pagopa/{fingerprint}` | pagoPA document |
| PATCH | `/pagopa/{fingerprint}` | edit pagoPA document |
| GET | `/pagopa/receipts/:id` | pagoPA receipts |
| GET | `/webhooks` | — |
| GET | `/webhooks/types` | — |
| DELETE | `/webhooks/{id}` | — |
| GET | `/webhooks/{id}` | — |
| PUT | `/webhooks/{id}/renew` | — |
| GET | `/{tenantID}/accounts` | — |
| GET | `/{tenantID}/consents` | — |
| POST | `/{tenantID}/consents` | — |
| GET | `/{tenantID}/balances` | Lista |
| GET | `/{tenantID}/balances/last` | Ultimi dati disponibili |
| GET | `/{tenantID}/bulk` | List bulk documents |
| POST | `/{tenantID}/bulk` | — |
| DELETE | `/{tenantID}/bulk/{fingerprint}` | — |
| GET | `/{tenantID}/bulk/{fingerprint}` | — |
| GET | `/{tenantID}/chain` | — |
| POST | `/{tenantID}/chain` | — |
| GET | `/{tenantID}/chain/{fingerprint}` | Get document details |
| POST | `/{tenantID}/checkout` | — |
| POST | `/{tenantID}/checkout/intents` | — |
| DELETE | `/{tenantID}/checkout/{code}` | — |
| PUT | `/{tenantID}/checkout/{code}/preferences` | Update checkout preferences |
| GET | `/{tenantID}/checkout/{type}/{fingerprint}` | — |
| GET | `/{tenantID}/invoices` | — |
| POST | `/{tenantID}/invoices` | — |
| GET | `/{tenantID}/invoices/preferences` | — |
| PUT | `/{tenantID}/invoices/preferences` | — |
| DELETE | `/{tenantID}/invoices/{fingerprint}` | — |
| GET | `/{tenantID}/invoices/{fingerprint}` | — |
| PATCH | `/{tenantID}/invoices/{fingerprint}` | — |
| PUT | `/{tenantID}/invoices/{fingerprint}` | — |
| GET | `/{tenantID}/payments/{service}/{fingerprint}` | — |
| GET | `/{tenantID}/salaries` | Recupera le buste paga. |
| PATCH | `/{tenantID}/salaries` | Aggiorna i dati delle buste paga (precedentemente caricate) |
| POST | `/{tenantID}/salaries` | Carica le buste paga dei dipendenti |
| DELETE | `/{tenantID}/salaries/{fingerprint}` | Elimina uno stipendio specifico |
| GET | `/{tenantID}/salaries/{fingerprint}` | Recupera i dettagli di una busta paga specifica |
| PATCH | `/{tenantID}/salaries/{fingerprint}` | Aggiorna i dati di una busta paga (precedentemente caricata) |
| GET | `/{tenantID}/transactions` | Lista |
| GET | `/{tenantID}/transactions/{transactionID}` | Transazione corrispondente all'identificativo |
| GET | `/{tenantID}/transfers` | — |
| POST | `/{tenantID}/transfers` | Creazione di un nuovo documento trasfert |
| POST | `/{tenantID}/transfers/plan` | — |
| DELETE | `/{tenantID}/transfers/{fingerprint}` | Cancella un documento transfer |
| GET | `/{tenantID}/transfers/{fingerprint}` | Recupera i dettagli di un documento transfer |
| GET | `/{tenantID}/webhooks` | — |
| POST | `/{tenantID}/webhooks` | — |
| DELETE | `/{tenantID}/webhooks/{id}` | — |
| GET | `/{tenantID}/webhooks/{id}` | — |
| PUT | `/{tenantID}/webhooks/{id}` | — |

## Machine-readable artifacts (9)

- **Documentation** — https://docs.flowpay.it/
- **APIReference** — https://docs.flowpay.it/
- **DeveloperPortal** — https://developer.flowpay.it/
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bancomat/refs/heads/main/openapi/bancomat-flowpay-api-v1-openapi.yml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bancomat/refs/heads/main/openapi/_original/bancomat-flowpay-api-v1-openapi.json
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/bancomat/refs/heads/main/asyncapi/bancomat-flowpay-webhooks.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/bancomat/refs/heads/main/sandbox/bancomat-sandbox.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/bancomat/refs/heads/main/overlays/bancomat-flowpay-api-v1-overlay.yaml
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/bancomat/refs/heads/main/skills/_index.yml

## Other Bancomat APIs (2)

- [BANCOMAT Pay](https://apis.io/apis/bancomat/bancomat-pay/)
- [FlowPay API (v2)](https://apis.io/apis/bancomat/flowpay-api-v2/)

## Tags

Open Banking, Account Information, Payment Initiation, Invoicing, Webhook, pagoPA, Italy

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/bancomat/flowpay-api-v1/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/bancomat/.