Guides
Start with the workflow you are implementing. These guides are ordered around first-time setup, payments, subscriptions, and operational reliability.
Start Here
Pick the shortest path to a test payment, then branch into the specific workflow you need.
Create a customer, create an order, create a payment intent, and reach your first successful Flint test payment.
Build an end-to-end card payment flow with Flint Pay, Stripe.js, and a simple frontend.
Install and use the official @flintpay/node package for typed Flint Pay integrations in Node.js and TypeScript.
Test successful payments, declines, retries, and go-live readiness with Flint test keys and Stripe test cards.
Create a Flint merchant and mint the first API key entirely over the API, without the dashboard.
Give AI coding agents one URL with Flint Pay schemas, docs, and integration conventions.
Take Payments
Build checkout, take orders, charge cards, send invoices, and issue refunds.
Build an end-to-end card payment flow with Flint Pay, Stripe.js, and a simple frontend.
Embed a payment form on your site using Flint Pay order-linked payment intents and Stripe Elements.
Understand why Flint centers commerce on orders before payment collection, and what that gives your integration.
Migrate common Stripe integrations to Flint for subscriptions, one-time payments, payment links, invoices, saved cards, refunds, and webhooks.
Migrate common Square payment flows to Flint for hosted checkout, embedded card payments, cards on file, subscriptions, invoices, refunds, and webhooks.
Create one hosted checkout flow for a specific order, quick-pay amount, or subscription signup.
Build reusable hosted payment pages for products, donations, events, and subscription signup flows.
Choose the right Flint primitive for reusable hosted links, one-off hosted checkout, or accounts receivable workflows.
Create invoices, send them to customers, and collect payment through hosted checkout or manual recording.
Run Subscriptions
Define plans, bill on a schedule, and manage recurring billing flows.
Make It Reliable
Handle webhooks, safe retries, and operational failures.
Register Flint webhook endpoints, verify signatures, process retries safely, and build idempotent handlers.
Understand Flint Pay error codes, status codes, and retry patterns for resilient integrations.
Understand Flint Pay rate limits, route classes, burst behavior, and bootstrap throttles.
Safely retry create and update calls with idempotency keys, without duplicate resources.