Skip to content
flint

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

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.

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.

What your storefront sends, per order
# 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.

Offer shipping on every checkout, once
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.

A shipping method, created once
# $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-methods

Offer 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-zones

US 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_money

Cards, 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_id

Guests pay without an account, and every paid order shows up in the account for their email.

buyer_contact.email

Automatic discounts apply on their own, and buyers type promotion codes on the checkout page.

promotion_config.codes_enabled

The 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 dripperpayingpaidshipped
On handon_hand_quantity252524
Heldheld_quantity100
Committedcommitted_quantity010
Available to sellavailable_quantity242424
One sale from a shelf of 25 at the Austin roastery, read from one inventory level. The unit stops being available the moment it is held, and leaves the shelf when the parcel goes to the carrier.

Name where an order ships from and paying it holds the stock. There is no decrement to write.

inventory_routing_source

Sell 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-policies

Keep a buffer at each location that is never offered for sale.

safety_stock_quantity

Two products can draw on one shelf, so a gift set and the single item never disagree about what is left.

inventory_item_id

Selling 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.

Ship order #CS-1042
# 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/fulfillments

The buyer is emailed when a package ships, is out for delivery, misses a delivery, and arrives. Tracking changes alone never email anyone.

fulfillment_updates

Pickup and local delivery run on the same fulfillment record, with a ready-for-pickup email.

mark_ready

Buyers follow every parcel from their account, and your backend hears every step.

fulfillment_event.created

What 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.

The whole policy
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.

ret_1kmn0aExample1 × Ceramic dripper
  • The decisiondecision_statusapproved
  • The merchandisemerchandise_statusresolved
  • The moneyresolution_statuscompleted
Order #CS-1042deliveredreturned
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_quantity2425
Returning the dripper refunds $25.98: its $24.00 plus its $1.98 share of the tax. The unit is back on the shelf because the return recorded where it went, and nobody did the math.

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.

app.withflintpay.com
Flint dashboard order detail: line items, totals with a line-item refund, the payment attempt and an activity timeline on one $19.43 order record
An order as your team sees it: line items, totals, a line-item refund, and the activity timeline, with nothing to build.

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
No monthly fee, no setup fee, and no price per seat.

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 fee

3.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.

  1. 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.

    Pricing →Commerce API →

  2. 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.

    Flint vs Shopify →BigCommerce alternatives →

  3. 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.

    Flint vs Medusa →Medusa vs Saleor vs Vendure →

  4. 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.

    Flint vs Stripe →Stripe alternatives →

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

npm install @flintpay/node

CLI

npm install -g @flintpay/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

  1. 01
  2. 02
  3. 03
  4. 04
  5. 05
  6. 06
  7. 07
  8. 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-23
  • The 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-23
  • Core 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-23
  • Medusa Cloud's Develop plan is from $29 a month. Medusa pricing

    medusajs.com · checked 2026-10-23
  • The 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-23
  • 2.9% + 30¢ per successful transaction for domestic cards, with no monthly fees. Stripe pricing

    stripe.com · checked 2026-10-23
  • You 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.