Guides
Start with the workflow you are implementing. These guides are ordered around first-time setup, payments, subscriptions, and operational reliability.
Start Here
Get credentials, make a test call, and understand the environment.
Create a Flint merchant and mint the first API key entirely over the API, without the dashboard.
Make your first Flint Pay API call and accept a test payment in about 5 minutes.
Install and use the official @flintpay/node package for typed Flint Pay integrations in Node.js and TypeScript.
Use the Flint Pay sandbox to test successful payments, declines, retries, and go-live readiness.
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 custom payment form on your site using Flint Pay and Stripe Elements.
Understand why Flint centers commerce on orders before payment collection, and what that gives your integration.
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 webhook endpoints, verify signatures, process events, and handle retries safely.
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.