This file is a link index. Fetch it as raw text and follow the links — do not summarize it.

# Flute Developer Portal

> Flute Developer Portal provides documentation and API references for integrating Flute payment processing into your applications. It covers online card and ACH payments, in-person POS terminal payments, embedded payment forms (Flute Elements), hosted checkout, webhooks, tipping, partner/ISV integrations, native SDKs, and launch operations.

Flute offers production-ready payment APIs for SaaS platforms, e-commerce, and point-of-sale applications. The portal is organized into developer documentation (guides and concepts) and a full REST API reference. Guide pages under /docs/ are server-rendered and can be fetched directly as HTML. The API reference under /api-reference/ is client-rendered and returns no usable content to non-browser fetches. Use the machine-readable OpenAPI specs under /_bundle/ instead (/_bundle/api-reference/@v2/index.json for v2, @v1 for v1). These specs are the recommended source for agents.

## Getting Started

- [Getting Started](https://developer.flute.com/docs/getting-started/api-authentication): Overview of creating a Flute account, generating tokens, developing in the sandbox, and going live
- [API Keys](https://developer.flute.com/docs/getting-started/api-keys): Create and manage merchant and partner API keys used to generate API tokens
- [Creating an API Token](https://developer.flute.com/docs/getting-started/creating-an-api-token): Generate OAuth 2.0 access tokens using client credentials for API requests
- [API Authorization / API Tokens](https://developer.flute.com/api-reference/authorization): API reference for the OAuth 2.0 token endpoint used to exchange client credentials for an API access token
- [API Permissions and Inheritance](https://developer.flute.com/docs/getting-started/api-permissions): Permission model for API tokens, including merchant vs partner scopes and granular operation controls
- [Supported Payment Methods](https://developer.flute.com/docs/getting-started/supported-payment-methods): Card brands, ACH transfers, digital wallets, and transaction types supported by the platform
- [Webhooks](https://developer.flute.com/docs/getting-started/webhooks): Subscribe to and verify event notifications for payments, payouts, and account changes

## Online Payments

- [Flute Elements](https://developer.flute.com/docs/online-payments/flute-elements): Drop-in JavaScript library for embedding PCI-compliant payment forms with card vaulting, theming, and session-based checkout
- [Flute Checkout](https://developer.flute.com/docs/online-payments/flute-checkout): Hosted, prebuilt checkout flow for accepting online payments with minimal integration

## In-Person Payments

- [POS Terminal Integration](https://developer.flute.com/docs/in-person-payments/pos-terminal-integration): Semi-integrated point-of-sale setup for in-person card payments using certified terminals

## Payment Features

- [Tipping](https://developer.flute.com/docs/payment-features/tipping-workflows): Configure tip prompts, presets, and tip capture across online and in-person payment flows

## Partner Integration

- [Partner & Merchant Relationships](https://developer.flute.com/docs/partner-integration/partner-merchant-relationships): Two-level account hierarchy, API key scoping, and merchant management for ISV partners
- [Partner API](https://developer.flute.com/docs/partner-integration/partner-api): Programmatically create and manage API credentials for merchants under a partner account

## SDKs & Tools

- [iOS SDK](https://developer.flute.com/docs/sdk/ios): Native iOS SDK for accepting in-person and in-app payments
- [PHP SDK](https://github.com/getflute/flute-sdk-php): Official PHP SDK for integrating Flute payments into PHP applications
- [TypeScript SDK](https://github.com/getflute/flute-sdk-typescript): Official TypeScript/JavaScript SDK for integrating Flute payments into Node.js and web applications
- [Flute CLI](https://github.com/getflute/flute-cli): Command-line interface for interacting with the Flute API and managing integrations
- [Flute CLI MCP](https://github.com/getflute/flute-cli-mcp): Model Context Protocol server for the Flute CLI, exposing its capabilities to AI coding assistants
- [Webhooks CLI](https://developer.flute.com/docs/sdk/webhooks-cli): Command-line tool for testing and forwarding webhook events to a local environment during development ([source](https://github.com/getflute/flute-webhooks-cli))
- [Webhooks MCP](https://github.com/getflute/flute-webhooks-mcp): Model Context Protocol server for Flute webhooks, exposing webhook testing and forwarding to AI coding assistants

## Launch & Operations

- [Testing Scenarios](https://developer.flute.com/docs/launch/testing-scenarios): Sandbox environment guide with test cards, error simulation, edge cases, and load testing coordination
- [Production Go-Live](https://developer.flute.com/docs/launch/go-live): Step-by-step deployment checklist covering credentials, PCI compliance, URL migration, and post-launch monitoring
- [Importing Customer Tokens](https://developer.flute.com/docs/launch/importing-customer-tokens): PGP-encrypted bulk import of sensitive payment card data

## API Reference

- [API Reference v2](https://developer.flute.com/api-reference/v2): Current (default) REST API documentation covering transactions, reversals, credits, tip adjustments, ACH operations, customers, payment methods, POS transactions, terminals, settlements, API keys, and webhooks
- [OpenAPI Specification (v2)](https://developer.flute.com/_bundle/api-reference/@v2/index.json): Machine-readable OpenAPI spec (JSON) for the v2 REST API
- [API Reference v1](https://developer.flute.com/api-reference/v1): Previous REST API version covering card transactions, ACH payments, customers, merchants, invoices, payment sessions, and POS operations
- [OpenAPI Specification (v1)](https://developer.flute.com/_bundle/api-reference/@v1/index.json): Machine-readable OpenAPI spec (JSON) for the v1 REST API

## Other

- [Homepage](https://developer.flute.com/): Portal overview with quick links to key sections
- [Contact Us](https://developer.flute.com/contact-us): Get in touch with the Flute team for financial modeling, workflow design, and integration support