# FlowPay API (v2)

**Canonical:** https://apis.io/apis/bancomat/flowpay-api-v2/  
**Provider:** Bancomat — https://apis.io/providers/bancomat/  
**Base URL:** https://api.flowpay.it/v2  
**Documentation:** https://github.com/FlowPay/client-openapi

FlowPay API (v2) 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 pagoPA. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

Second-generation FlowPay API published as OpenAPI 3.1.0 (2.0.0-alpha.4) in the public FlowPay/client-openapi GitHub repository, with operationIds, page/size pagination, documented 100 req/min and 10 req/s rate limits, and a shared public sandbox. Adds credit notes, proforma invoices, construction-site escrow flows, fee rules and KYC to the v1 surface, and describes an AIS consent-status webhook. The production server api.flowpay.it/v2 answers unauthenticated reads (GET /v2/banks returned 200 on 2026-09-17) even though the spec still labels it "Not implemented".

## Operations (59)

| Method | Path | Summary |
|---|---|---|
| POST | `/oauth/token` | Get an access token or refresh an existing one |
| POST | `/oauth/token/info` | Get information about the token |
| GET | `/accounts` | Get the list of accounts |
| POST | `/accounts` | Create account consent session |
| GET | `/accounts/{accountID}` | Get account details |
| GET | `/banks` | Get banks |
| GET | `/banks/{id}` | Get bank details |
| POST | `/bulk` | Create bulk document |
| GET | `/bulk` | List bulk documents |
| GET | `/bulk/{fingerprint}` | Get document details |
| DELETE | `/bulk/{fingerprint}` | Delete bulk payment |
| POST | `/chain` | Create chain document |
| GET | `/chain` | List chain documents |
| GET | `/chain/{fingerprint}` | Get document details |
| POST | `/checkout` | Create checkout |
| GET | `/checkout/{code}` | Get checkout details |
| DELETE | `/checkout/{code}` | Delete checkout |
| POST | `/creditNotes` | Create credit note |
| GET | `/creditNotes` | List credit notes |
| GET | `/creditNotes/{fingerprint}` | Get credit note details |
| DELETE | `/creditNotes/{fingerprint}` | Delete credit note |
| POST | `/constructions/contracts` | Add worker to site |
| GET | `/constructions/contracts` | List workers |
| PATCH | `/constructions/contracts/{identifier}` | Accept assignment |
| DELETE | `/constructions/contracts/{identifier}` | Contract withdrawal |
| POST | `/constructions/sites` | Open a new site |
| GET | `/constructions/sites` | List sites |
| GET | `/constructions/sites/{identifier}` | Get site details |
| POST | `/constructions/sites/{identifier}/cashout` | Cashout |
| POST | `/constructions/sites/{identifier}/quote` | Create quote |
| GET | `/constructions/sites/{identifier}/quote` | List quotes |
| POST | `/constructions/progress` | Register work progress |
| GET | `/constructions/progress` | List work progress |
| GET | `/constructions/progress/{identifier}` | Get work progress details |
| GET | `/fee` | List fees |
| GET | `/fee/rules` | List fee rules |
| GET | `/fee/rules/{kind}/{fingerprint}` | Retrieve fee rules for a document |
| GET | `/fee/rules/{kind}/{fingerprint}/{payer}` | Retrieve fee rule for a specific payer |
| POST | `/invoices` | Create invoice |
| GET | `/invoices` | List invoices |
| GET | `/invoices/{fingerprint}` | Get invoice details |
| POST | `/kyc` | Start KYC |
| GET | `/kyc/{identifier}` | Get KYC data |
| POST | `/pagopa` | pagoPA payment |
| GET | `/pagopa` | pagoPA list |
| GET | `/pagopa/{fingerprint}` | Get pagoPA details |
| GET | `/pagopa/{fingerprint}/receipt` | Get pagoPA receipt |
| GET | `/payments` | Get payments |
| GET | `/payments/{paymentID}` | Get payment details |
| POST | `/proforma` | Create proforma invoice |
| GET | `/proforma` | List proforma invoices |
| GET | `/proforma/{fingerprint}` | Get proforma details |
| DELETE | `/proforma/{fingerprint}` | Delete proforma invoice |
| GET | `/transactions` | Get transactions |
| GET | `/transactions/{transactionID}` | Get transaction details |
| GET | `/transfers` | Get transfers |
| POST | `/transfers` | Create transfer |
| GET | `/transfers/{transferID}` | Get transfer details |
| DELETE | `/transfers/{transferID}` | Delete transfer |

## Machine-readable artifacts (8)

- **Documentation** — https://github.com/FlowPay/client-openapi/tree/main/docs
- **SourceCode** — https://github.com/FlowPay/client-openapi
- **DeveloperPortal** — https://developer.flowpay.it/
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bancomat/refs/heads/main/openapi/bancomat-flowpay-api-v2-openapi.yml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bancomat/refs/heads/main/openapi/_original/bancomat-flowpay-api-v2-openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/bancomat/refs/heads/main/overlays/bancomat-flowpay-api-v2-overlay.yaml
- **MCPServer** — https://raw.githubusercontent.com/api-evangelist/bancomat/refs/heads/main/mcp/bancomat-mcp.yml
- **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 (v1)](https://apis.io/apis/bancomat/flowpay-api-v1/)

## Tags

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

---

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