Bancomat

Bancomat Bulk API

Questo endpoint consente di effettuare pagamenti bulk di documenti di diversi tipi. Nota: l'API di questo endpoint non richiede scope specifici, il token di autorizzazione utilizzato deve avere accesso ai documenti che desidera pagare. Il diagramma sopra mostra come funziona bulk. Supponiamo il caso in cui un utente abbia due fatture per il beneficiario 1 (Ben1), una fattura per il beneficiario 2 (Ben2) e un pagamento PagoPA L'utente desidera pagare tutti in un'unica operazione. Il client dell'utente, che ha accesso a tutti i documenti, chiama l'endpoint in blocco con l'elenco dei documenti da pagare, l'endpoint restituisce un nuovo documento (Bulk) collegato a tutti i documenti da pagare. Il client fornisce il documento bulk all'utente, che ora può pagarlo con un'unica operazione di Payment Initiation (PIS). Il bonifico bancario consentito con PIS sul documento in blocco è indirizzato al conto tecnico FlowPay (TA). Quando il TA riceve il pagamento, divide l'importo tra i beneficiari e invia loro i pagamenti tramite bonifico bancario. In caso di pagamento bulk allo stesso beneficiario, il beneficiario effettivo di avvio del pagamento è il beneficiario stesso, quindi il pagatore può riconoscere facilmente la transazione. In caso contrario, il beneficiario effettivo di avvio del pagamento è FlowPay. I bonifici bancari ai beneficiari vengono inviati con lo stesso pagatore originale, quindi i beneficiari possono identificare facilmente il pagatore. Nota: il destinatario dei pagamenti pagoPA è FlowPay stesso, quindi i pagamenti correlati non vengono conteggiati nelle operazioni di suddivisione.

GitHub OpenAPI

Operations 8

GET /{tenantID}/bulk List bulk documents #
POST /{tenantID}/bulk Create by tenant id bulk #
DELETE /{tenantID}/bulk/{fingerprint} Delete by tenant id bulk by fingerprint #
GET /{tenantID}/bulk/{fingerprint} Get by tenant id bulk by fingerprint #
POST /bulk Create bulk document #
GET /bulk List bulk documents #
GET /bulk/{fingerprint} Get document details #
DELETE /bulk/{fingerprint} Delete bulk payment #

Documentation

📖
Documentation
https://docs.flowpay.it/
📖
APIReference
https://docs.flowpay.it/
📖
Documentation
https://github.com/FlowPay/client-openapi/tree/main/docs

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bancomat/refs/heads/main/openapi/bancomat-bulk-api-openapi.yml

Other Resources

🔗
DeveloperPortal
https://developer.flowpay.it/
🔗
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
🔗
SourceCode
https://github.com/FlowPay/client-openapi

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/bancomat-bulk-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bancomat-bulk-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Bancomat Bulk API
  x-refined-note:
  - x-json-schema-faker differs across the merged source definitions and was not carried
  - x-logo differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged Bulk across 2 of this provider''s published API definitions: bancomat-flowpay-api-v1-openapi.json, bancomat-flowpay-api-v2-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://app.flowpay.it/api
  variables: {}
- url: https://api.flowpay.it/v2
  description: Production server (Not implementend)
- url: https://mock.flowpay.it/v2
  description: Mock server
- url: https://sandbox.{customerID}.flowpay.it/v2
  description: Customer-assigned sandbox server
  variables:
    customerID:
      default: 00000000-00000000-00000000-00000000
      description: Unique customer identifier assigned after contract signature
- url: http://localhost:5002
  description: Debug
tags:


# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/bancomat/refs/heads/main/openapi/bancomat-bulk-api-openapi.yml