Implement a Yapily data enrichment flow combining account aggregation with transaction categorization for a B2B expense analytics platform

domain: docs.yapily.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create an institution connection for the user by POST /account-auth-requests with applicationUserId, institutionId, and callback; redirect the user to the returned authorisationUrl to complete Open Banking consent
  2. After redirect, exchange the consent token by POST /accounts with the consent header; receive a list of accounts including accountType, balance, and currency
  3. Fetch transactions via GET /accounts/{accountId}/transactions?from=YYYY-MM-DD&to=YYYY-MM-DD using the consent header; Yapily returns raw transaction data including merchant name, amount, transaction type, and ISO category codes where provided by the ASPSP
  4. Enrich raw transactions using Yapily's categorization (where enabled in your plan) by checking the enrichment object on each transaction; fields include transactionCategory, merchant, and logo URL
  5. For ASPSPs that do not provide categorization data, forward raw transactions to a categorization service (e.g., Plaid Enrich or your own ML model) using the transaction narrative as input
  6. Aggregate enriched transactions by merchant and category across multiple connected accounts; store the accountId, institutionId, and consent expiry date per connection to manage re-consent workflows proactively

Known gotchas

Related routes

Implement Tink transaction enrichment with merchant data and personal finance category for PFM integration
account-aggregation/Tink · 6 steps · unrated
Implement Plaid Enrich to categorize transactions with PFC v2 taxonomy and apply merchant normalization
plaid.com · 6 steps · unrated
Auto-categorize bank feed transactions into GL accounts with rules and review queues
accounting-general · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans