Ecommerce platform
Build the storefront.Flint runs the store behind it.
Flint is the ecommerce platform behind stores that sell on their own website. Your storefront sends the cart. Flint prices it from your catalog, takes payment on a checkout that quotes shipping and sales tax, holds the stock, emails the receipt and the tracking number, gives every buyer an account, and turns returns into refunds to the line item.
3.79% + 35¢ on cards · no monthly fee · free sandbox · no credit card
One order, start to finish
order.paidOct 6Receipt emailed, stock committed
package.updatedOct 7Shipped, tracking link emailed
fulfillment.completedOct 9Delivered
return.completedOct 19Dripper back on the shelf, $25.98 refunded
3.79% + 35¢
per card payment, with no monthly fee
published rate card
6
kinds of buyer email sent with your store's name
customer_email_delivery
735
API operations behind your storefront
counted from the OpenAPI spec
01The split
Your site sells. Flint runs everything after Buy.
Buyers judge a store by its pages, so those stay yours: any design, any framework, any host. Every system the store needs once a buyer clicks Buy is already running on Flint, on the order your storefront creates.
You build
The storefront
The pages buyers browse, built your way.
- Product pages, collections, and search
- The cart, and how every page looks
- Your domain, your hosting, and how you rank in search
- Any framework with a server to call Flint from: Next.js, Remix, Astro, Rails, or Laravel
No site yet? Sell from a payment link while it’s built. Building it with an AI coding tool? Sell online with AI shows the whole loop.
Flint runs
- CatalogProducts, variants, bundles, and prices. Every line is priced on the server.POST /v1/products
- CheckoutHosted or in your pages, with shipping and sales tax quoted before payment.POST /v1/checkout-sessions
- InventoryStock held the moment a buyer pays, across every location you sell from.GET /v1/inventory-levels
- ShippingShipments, tracking numbers, and the emails that tell the buyer.GET /v1/fulfillments
- ReturnsYour policy, self-serve requests, restocking, and refunds to the line item.POST /v1/returns
- Buyer accountsOrders, tracking, returns, subscriptions, and saved cards, for every buyer.GET /v1/me/orders
- Payments and payoutsCards, wallets, Affirm, and bank debit on Stripe, paid out to your bank.GET /v1/payouts
- The dashboardProducts, orders, packing, returns, and reports, with unlimited seats.app.withflintpay.com
02Checkout
Shipping and tax are on the total before the buyer pays.
Send the cart as variants and quantities, then redirect. Flint's checkout collects the address, offers the shipping options that address qualifies for, adds sales tax, and shows the final total under your store's name.
# 1. the cart, by variant. prices and tax come from your catalog
curl -X POST https://api.withflintpay.com/v1/orders \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: cart-7f3a" \
-d '{
"customer_id": "cus_1kmn0aExample",
"line_items": [
{
"type": "variant",
"variant_id": "var_1kmn0aExample",
"quantity": 1
},
{
"type": "variant",
"variant_id": "var_2kmn0aExample",
"quantity": 1
},
{
"type": "variant",
"variant_id": "var_3kmn0aExample",
"quantity": 1
}
],
"tax": { "enabled": true },
"inventory_routing_source": {
"type": "fixed_location",
"location_id": "loc_1kmn0aExample"
}
}'
# 2. the checkout. send the buyer to data.url
curl -X POST https://api.withflintpay.com/v1/checkout-sessions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: checkout-7f3a" \
-d '{ "type": "order", "order_id": "ord_1kmn0aExample" }'Variants and quantities only. Names, prices, tax rules, and stock tracking come from your catalog, so the browser never supplies a price.
curl -X PATCH https://api.withflintpay.com/v1/settings \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"checkout": {
"default_delivery_method_ids": ["dmet_1kmn0aExample"]
}
}'Up to 25 methods can be checkout defaults, so shipping, two-day, and pickup can sit side by side.
# $6 shipping, free on orders of $75 or more
curl -X POST https://api.withflintpay.com/v1/delivery-methods \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: standard-shipping-001" \
-d '{
"name": "Standard shipping",
"type": "shipment",
"status": "active",
"configuration": {
"origin": {
"type": "fixed_location",
"location_id": "loc_1kmn0aExample"
},
"eligibility": { "country": { "values": ["US"] } },
"pricing": {
"type": "tiered",
"tiered": {
"basis": "order.merchandise_subtotal_before_discounts",
"bands": [
{
"from": 0,
"to": 7500,
"currency_options": {
"USD": { "amount": 600, "currency": "USD" }
}
},
{
"from": 7500,
"currency_options": {
"USD": { "amount": 0, "currency": "USD" }
}
}
]
}
},
"estimate": {
"type": "transit_time",
"transit_time": {
"handling_days": { "minimum": 1, "maximum": 1 },
"transit_days": { "minimum": 2, "maximum": 5 }
}
}
}
}'$6 below $75 and free from $75, with an arrival estimate the checkout prints beside the price: Arrives Oct 9-14 for an order placed on Tuesday, October 6.
Price shipping as a flat rate, by region from a rate table, by order value like free over $75, by distance for local delivery, or with a live rate your own server returns.
POST /v1/delivery-methodsOffer pickup at your shop and local delivery in a time window beside shipping, and limit any method to the zones you draw.
POST /v1/delivery-zonesUS sales tax is calculated from the shipping address, on the items and the shipping charge, and each line keeps its own share for later refunds.
pricing_amounts.tax_moneyCards, Apple Pay, Google Pay, Affirm, and ACH bank debit on the same page, and buyers who sign in check out with a saved card.
customer_idGuests pay without an account, and every paid order shows up in the account for their email.
buyer_contact.emailAutomatic discounts apply on their own, and buyers type promotion codes on the checkout page.
promotion_config.codes_enabledThe shipping guide sets up a flat rate in three calls, delivery options adds regional rates, pickup, and local delivery, and sales tax covers rates, categories, and tax reports. Every payment method and setting is on the checkout page.
03Inventory
The last one sells once.
A tracked product holds its stock when the buyer pays, commits it when the payment succeeds, and lets it go if the payment fails. If no location can fill the order, the payment fails before any money moves.
| Ceramic dripper | paying | paid | shipped | |
|---|---|---|---|---|
| On handon_hand_quantity | 25 | 25 | 24 | |
| Heldheld_quantity | 1 | 0 | 0 | |
| Committedcommitted_quantity | 0 | 1 | 0 | |
| Available to sellavailable_quantity | 24 | 24 | 24 | |
Name where an order ships from and paying it holds the stock. There is no decrement to write.
inventory_routing_sourceSell from several warehouses or shops. A routing policy ranks them and splits an order only when no single location can fill it.
POST /v1/inventory-allocation-policiesKeep a buffer at each location that is never offered for sale.
safety_stock_quantityTwo products can draw on one shelf, so a gift set and the single item never disagree about what is left.
inventory_item_idSelling at a market or on a marketplace as well? Record those sales against the same stock, or sync counts from your warehouse system.
POST /v1/inventory-adjustments- inventory_reservation_id
- inventory_exception_status
- GET /v1/inventory-levels
- inventory_level.updated
The inventory guide follows one unit from the receiving dock to a paid, shipped order. Selling on Stripe today? Stripe inventory management covers holding stock at checkout and the gaps that oversell during a rush.
04Shipping
Ship it, and the buyer hears about it.
Paying the order creates its fulfillment from the buyer's shipping choice. Add the tracking number and mark the package shipped: the buyer gets the tracking link, the stock leaves your shelf, and the parcel shows up in their account.
# order.paid arrived. Flint already made the fulfillment from the buyer's shipping choice
curl "https://api.withflintpay.com/v1/fulfillments?order_id=ord_1kmn0aExample" \
-H "Authorization: Bearer YOUR_API_KEY"
# the carrier leg, then the box with its label's tracking number
curl -X POST https://api.withflintpay.com/v1/shipments \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"direction": "outbound",
"fulfillment_id": "ful_1kmn0aExample",
"external_system": "austin-packing",
"external_reference_id": "cs-1042"
}'
curl -X POST https://api.withflintpay.com/v1/packages \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: cs-1042-box-1" \
-d '{
"shipment_id": "shp_1kmn0aExample",
"status": "created",
"carrier": "usps",
"tracking_number": "9400100000000000000000",
"tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9400100000000000000000"
}'
# what is in the box, one call per order line
curl -X POST https://api.withflintpay.com/v1/packages/pkg_1kmn0aExample/items \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{ "order_line_item_id": "li_1kmn0aExample", "quantity": 1 }'
# when the carrier takes it: the buyer gets the tracking link, the stock leaves the shelf
curl -X POST https://api.withflintpay.com/v1/packages/pkg_1kmn0aExample/mark-shipped \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{}'Call it from your packing station, your warehouse system, or your 3PL's webhook. Packing in-house? Type the tracking number on the order in the dashboard and mark it shipped there.
Paying the order creates its fulfillment from the shipping option the buyer chose, split by the location holding the stock.
GET /v1/fulfillmentsThe buyer is emailed when a package ships, is out for delivery, misses a delivery, and arrives. Tracking changes alone never email anyone.
fulfillment_updatesPickup and local delivery run on the same fulfillment record, with a ready-for-pickup email.
mark_readyBuyers follow every parcel from their account, and your backend hears every step.
fulfillment_event.createdWhat the parcel reports
- shipped
- in_transit
- out_for_delivery
- delivery_attempted
- delivered
Email sent for you
- order_receipts
- fulfillment_updates
- subscription_lifecycle
- dunning
- returns
- invoices
The fulfillment guide covers split shipments and every email, and the customer accounts page shows what buyers see.
05Returns
Returns run on your rules, not your inbox.
Write the policy once: the window, who pays return shipping, when the money goes back. Buyers start the return from their account, the policy decides it, and the refund is worked out from the line item.
curl -X POST https://api.withflintpay.com/v1/return-policies \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: policy-standard-001" \
-d '{
"name": "Standard returns",
"revision": {
"priority": 100,
"scope": { "match_type": "all" },
"eligibility_result": "eligible",
"return_window": {
"duration_seconds": 2592000,
"starts_at_event": "delivered"
},
"allowed_resolution_types": ["refund", "exchange"],
"approval_mode": "automatic",
"resolution_mode": "manual",
"completion_mode": "automatic",
"receipt_disposition_mode": "automatic",
"release_timing": "after_receipt",
"is_merchandise_return_required": true,
"is_inspection_required": false,
"receiving_location_id": "loc_1kmn0aExample",
"return_shipping": { "payer": "buyer" }
}
}'Everything is returnable for 30 days from delivery and approved automatically. The buyer pays return shipping, the refund goes out when the parcel arrives, and the unit goes back on sale at the location named.
- The decisiondecision_statusapproved
- The merchandisemerchandise_statusresolved
- The moneyresolution_statuscompleted
| Order #CS-1042 | delivered | returned | |
|---|---|---|---|
| Whole-bean coffee | $16.00 | $16.00 | |
| Ceramic dripper | $24.00 | $24.00 | |
| Filter papers | $9.00 | $9.00 | |
| Standard shipping | $6.00 | $6.00 | |
| Taxtax_money | $4.54 | $4.54 | |
| Totaltotal_money | $59.54 | $59.54 | |
| Refundedrefunded_money | $0.00 | $25.98 | |
| Drippers on handon_hand_quantity | 24 | 25 | |
Final sale
A higher-priority policy scoped to a product or category marks it ineligible, so clearance stays sold.
Exchanges
Swap for another size or variant on the same return. If the new item costs more, the buyer pays the difference on a hosted checkout.
Keep it
Approve a refund with nothing to send back when return shipping would cost more than the item.
Fees and inspection
Charge a restocking fee, or hold the refund until someone has inspected what came back.
- POST /v1/return-policies
- POST /v1/return-previews
- POST /v1/returns
- completion_blockers
- return.completed
A warehouse key can record what arrived without being able to refund anyone. The returns guide covers mail-in and in-store returns, and the policy guide covers every rule. No policy written yet? The return policy generator writes the text for your store and the matching request.
06Dashboard
Run the whole store from one dashboard.
Everyone who works the store gets a seat, with no price per seat. Products, stock, packing, returns, discounts, customers, and payouts are all there, and none of it needs code.
Products and stock
Create products and variants, count the shelves, and move stock between locations.
Orders and packing
Every order with its payments, refunds, and timeline. Type a tracking number and mark the package shipped.
Returns
Write return policies, record what came back, and inspect it before the refund goes out.
Discounts and gift cards
Promotion codes, automatic discounts, buy-one-get-one offers, and gift cards you sell and redeem yourself.
Subscriptions
Subscribe-and-save on any product, with renewals that ship like any other order.
Money
Sales analytics, payouts to your bank on your schedule, disputes, fraud rules, and CSV reports for your accountant.

Each of these has its own page: subscriptions, gift cards, payment links, and invoices for wholesale orders.
07Yours
Start hosted. Take over any page when you want it.
Every hosted page has an API twin. Replace one at a time, in any order, and the orders, customers, and history never move.
checkout
Day one. A hosted checkout under your store's name and colors, on a hostname of yours with the $15-a-month custom domain add-on.
When you want it. The same checkout session inside your pages, with card fields from Stripe Elements. Flint still prices the order and takes the payment.
buyer account
Day one. Orders, tracking, returns, subscriptions, and saved cards, behind a sign-in code Flint emails the buyer.
When you want it. Your own account pages on the buyer API, signed in through your login.
buyer email
Day one. Receipts, shipping updates, return updates, and the rest of the buyer email, sent with your store's name and logo.
When you want it. One setting per family hands it to your own sender. The webhook events keep firing.
storefront
Day one. Payment links sell a product from a URL before the site exists.
When you want it. Your framework, your host, your design, with no theme engine to work around.
Build a headless storefront · Custom domains · Send your own buyer email
08Pricing
You pay when you sell, with no monthly fee.
Order #CS-1042 cost Cedar & Stone $2.91 in Flint fees. Stripe processes the card underneath, and its fees are inside Flint's rate, so there is no second processing bill.
| Fees on order #CS-1042 | ||
|---|---|---|
| Order #CS-1042, paid by card | $59.54 | |
| Card processing, 3.79% + 35¢ | $2.61 | |
| Automatic sales tax, 0.50% | $0.30 | |
| Flint's fees on the order | $2.91 | |
The store comes with the rate. Catalog, checkout, inventory, shipping, returns, buyer accounts, and the dashboard have no price of their own.
Add what you use. Automatic sales tax is 0.50% of payments that carry tax. Subscriptions add 0.40% of what they collect. Checkout and buyer accounts on your own domain are $15 a month.
Refunds cost nothing to issue. The original processing and add-on fees are kept. Every other fee is on the pricing page.
Core payments
No monthly fee3.79% + 35¢
Per successful card or wallet payment
- ACH 1.00%, $1 minimum, no cap
- Affirm 6.99% + 30¢ on purchases from $50 to $30,000
- Orders, catalog, discounts, fulfillment, returns and buyer portal
- 20 orders paid outside Flint a month, plus 1 for every $1,000 collected through Flint, then $1 each
- Unlimited sandbox testing and seats
Add what you use
Payment-time fees are collected with processing. Custom domains are billed monthly.
- Invoices and subscriptions
- 0.40% of collected payments
- Automatic tax
- 0.50% of payments where Flint collects tax
- Custom domain
- $15/month per business
09Compared
Choosing an ecommerce platform.
Most stores pick a hosted store platform, an open-source commerce backend, or a payments API with the rest built by hand. Flint keeps the storefront yours and runs everything behind it, with payments included.
- 01
Flint
For a store on its own site that wants the back office run for it and payments included.
- 3.79% + 35¢ per card payment, no monthly fee, with Stripe's processing inside the rate.
- Checkout, inventory, shipping, returns, buyer accounts, and the dashboard come with the account. There is no commerce backend to host.
- Your storefront, on any framework, with checkout hosted on your domain or built into your pages.
- 02
A hosted store platform
Shopify, BigCommerce
For a store built from a theme, inside the platform.
- Shopify Basic is $39 a month billed monthly. Taking payments through a provider other than Shopify Payments adds 2% on Basic, and that fee isn't returned on refunds.
- BigCommerce Core is $39 a month billed monthly, for up to $30K of sales over the trailing 12 months before the plan upgrades.
Where it’s strong: themes and an app store, for a store with no developer.
- 03
An open-source commerce backend
Medusa, Saleor
For a team that wants to own and change the backend's code.
- Medusa Cloud starts at $29 a month. Payments run through a provider you configure with your own Stripe secret key and webhook secret.
Where it’s strong: the source code is yours to change.
- 04
A payments API and your own code
Stripe
For a team that wants to build the store around the payment itself.
- Stripe's fulfillment guide has you write the server function that ships the goods and updates stock records after each Checkout payment.
Where it’s strong: a lower card rate, 2.9% + 30¢ for US cards with no monthly fee.
Weighing more options? Headless commerce platforms compared ranks ten, Flint included, with how each takes payments and what it costs to start. Every comparison lists its sources.
10Start
Put one order through the whole store.
Sandbox keys are free. Create a product, sell it with a test card, ship it, and return it, and watch one order carry all of it.
Node
CLI
Building the storefront with an AI agent? Sell online with AI shows it reading the docs and paying its own test order. Building in Next.js? Next.js commerce has the server action.
Then read these
- 01
- 02
- 03
- 04
- 05
- 06
- 07
- 08
Or run npm install -g @flintpay/cli && flint signup to create your account and a sandbox key from the terminal. CLI guide
Sources
Where each outside claim comes from.
Basic is $39 USD a month billed monthly, and the third-party transaction fee on Basic is 2%. Shopify Payments' online standard card rate on Basic is 2.9% + 30¢. Shopify pricing (US, billed monthly)
www.shopify.com · checked 2026-10-23The fee applies when you use a third-party payment provider, and it isn't returned when you refund an order. Shopify Help Center: Third-party transaction fees
help.shopify.com · checked 2026-10-23Core is $39 a month billed monthly, for up to $30K of trailing-12-month GMV, after which the plan upgrades to Growth. BigCommerce pricing
www.bigcommerce.com · checked 2026-10-23Medusa Cloud's Develop plan is from $29 a month. Medusa pricing
medusajs.com · checked 2026-10-23The Stripe provider is configured with your Stripe secret API key and a webhook secret, and enabled per region. Medusa docs: Stripe payment provider
docs.medusajs.com · checked 2026-10-232.9% + 30¢ per successful transaction for domestic cards, with no monthly fees. Stripe pricing
stripe.com · checked 2026-10-23You create a function on your server to fulfill successful Checkout payments; it can trigger shipment of goods and update inventory or stock records. Stripe docs: Fulfill orders
docs.stripe.com · checked 2026-10-23
last reviewed 2026-10-23 · corrections: Flint Help
FAQ
Questions sellers ask before they switch.
Is Flint an ecommerce platform?
Flint is the ecommerce platform behind a storefront you build. You design and host the pages buyers browse, in any framework. Flint runs the rest: the catalog and prices, a checkout that quotes shipping and sales tax, inventory, shipping updates, buyer accounts, returns, refunds, payouts, and the dashboard your team works in. Payments are part of the same account and process on Stripe, so there is no separate payment gateway to connect.
Do I need a developer to sell with Flint?
For the storefront, yes, or an AI coding tool that writes it, because your site calls Flint from its own server. Everything after that runs without code: you add products, pack orders, handle returns, and get paid from the dashboard. Payment links sell a product from a URL before the site exists, and sell online with AI shows an agent building the storefront.
How much does Flint cost for an online store?
3.79% + 35¢ per card or wallet payment, with no monthly fee, and Stripe's processing is inside that rate. Automatic sales tax adds 0.50% on payments that carry tax, subscriptions add 0.40%, and checkout on your own domain is $15 a month. On a $59.54 order with sales tax, Flint's fees come to $2.91. The sandbox is free.
How does Flint calculate shipping at checkout?
You create delivery methods once, and the checkout offers each buyer the ones their address and cart qualify for. A method can charge a flat rate, read a rate table by region, step through tiers by order value, charge by distance for local delivery, or ask your own server for a live rate. Pickup and local delivery are methods too. The chosen option adds its charge and its tax to the order before the buyer pays. Flint doesn't buy shipping labels: print them with your carrier or shipping app and add the tracking number to the package.
How does Flint stop overselling?
Stock is claimed, not counted down. When an order with tracked items is paid, Flint holds the units, commits them when the payment succeeds, and releases them if it fails. If no location can fill the order, the payment fails before any money moves. Units leave the shelf when the parcel is handed to the carrier, and what is available is always what is on hand minus what is held, committed, or kept back as safety stock.
Who sends the order confirmation and shipping emails?
Flint does, with your store's name and logo. Buyer email comes in six families: receipts, shipping updates, subscription notices, failed-payment notices, returns, and invoices. Any family switches to your own sender with one setting, and the webhook events behind it keep firing, so your code has what it needs to write them.
How do returns work?
You write a return policy once: what is returnable, for how long, who pays return shipping, any restocking fee, and when the money goes back. Buyers start a return from their account, the policy can approve it on its own, and the refund is worked out from what the item sold for, including its share of tax. Recording where a returned unit ended up is what puts it back in stock. Exchanges, replacements, and refunds with nothing to send back run on the same return.
Can checkout and the buyer account run on my own domain?
Yes, two ways. With the custom domain add-on, $15 a month, Flint's hosted checkout and buyer account run on hostnames you own, such as pay.yourstore.com and account.yourstore.com, and Flint issues and renews their certificates. Or build either page into your own site with the API, and Flint keeps pricing the order and taking the payment.
Can I sell subscriptions and one-time products in the same store?
Yes. Put a subscribe-and-save offer on any product, and one cart can mix one-time items with items the buyer subscribes to. Every renewal is an order, so it ships, emails, and refunds like any other. Buyers change their address, skip a shipment, or change how often it comes from their account, within the options you offer.
Can I sell outside the United States?
Flint onboards businesses based in the United States. Buyers can pay from anywhere, international cards add 1.50%, and a shipping method can serve whichever countries you choose. Automatic sales tax covers US addresses.
How is Flint different from Shopify?
Flint runs the store behind a site you build yourself, with no monthly fee: cards are 3.79% + 35¢ with Stripe’s processing included, and checkout runs on your own pages or your own domain. Shopify hosts a store built from a theme on a monthly plan, from $39 for Basic billed monthly, and on Basic adds a 2% fee when you take payments through a provider other than Shopify Payments. Flint vs Shopify compares the two need by need.


