Skip to content

Close your account

You can't close a Flint account from the Dashboard, the API, or the CLI. Flint support closes it for you. Before you ask, stop selling so no buyer is charged after the account closes, and take what you need from it. Do these in order:

  1. Stop new sales.
  2. End recurring charges.
  3. Turn off plans and products.
  4. Settle open invoices and gift cards.
  5. Export your data.
  6. Receive your last payout.
  7. Shut off access.
  8. Ask Flint support to close the account.

A closed account is permanent: closed is a terminal merchant status.

1. Stop new sales#

Set each payment link's status to inactive, and set inactive_message to tell buyers why. Buyers who open the URL see "This link isn't taking payments". See Control availability.

Also stop creating checkout sessions, orders, and invoices from your own site or integration.

2. End recurring charges#

Deactivating a plan or a product doesn't stop renewals. An inactive plan takes no new subscribers, but existing subscriptions keep renewing, and buyers keep being charged. Cancel every subscription yourself.

  • A default cancel on an active or trialing subscription takes effect at the next time Flint would charge it, and that charge doesn't happen. Send cancel_immediately: true to end it now. A scheduled, incomplete, or paused subscription, or a past_due one with no retry date, needs cancel_immediately: true. See Cancel.
  • There is no bulk cancel. List subscriptions with GET /v1/subscriptions?status=active, then cancel each with POST /v1/subscriptions/{subscription_id}/cancel. In the Dashboard, open each subscription from Subscriptions. Repeat the list for every other status except canceled: trialing, past_due, paused, scheduled, and incomplete.
  • On a plan that ships, canceling doesn't cancel a renewal order that's already paid. That shipment still goes out unless you refund and cancel the order.

3. Turn off plans and products#

After the subscriptions end, set each plan to inactive. Flint refuses while a payment link still sells the plan, so finish step 1 first.

You can then set products, variants, and bundles to inactive. Flint refuses while an open checkout session, an open invoice payment attempt, an active payment link, a plan that isn't archived, or an active subscription still uses the item. Read details[0].blocking_resources on the error to see what is left. When a plan blocks it, archive the plan once nothing is left on it. See Catalog setup.

4. Settle open invoices and gift cards#

  • Invoices. Void each draft or open invoice. A payment still in progress blocks the void until it finishes, and an invoice that already has money collected can't be voided; the same section covers those. See Void an invoice.
  • Gift cards. Flint closes a card only after its remaining value and reservations are resolved. Cash out the value where the card allows it, then close the card. See Freeze, unfreeze, or close a card.

5. Export your data#

Do this before the account closes.

  • Reports. Create CSV reports for any period from Reports in the Dashboard or with POST /v1/reports. They cover orders, invoices, payments, balance transactions, payouts, Flint billing, tax, and gift card liability. See Reports.
  • Subscriptions. Select subscriptions in the Dashboard list and choose Export CSV.
  • Customers, products, and other records. There is no export file. Read them with the API, following pagination until the last page.
  • Customer deletion requests. Approve or reject any open customer deletion request before you ask for closure.

6. Receive your last payout#

After you stop selling, Flint pays out your remaining balance on your normal payout schedule. Funds from recent sales become available after the settlement delay, so the last payout can arrive days after the last sale. Check Balances in the Dashboard or GET /v1/balances, and ask for closure after the balance has been paid out. A closed account can't send payouts.

Leave your payout bank account in place until then. Flint refuses to remove the default bank account for a currency, whether or not a balance is pending. To use a different account, make another destination the default first.

7. Shut off access#

  • Webhook endpoints. Delete each one with DELETE /v1/webhook-endpoints/{webhook_endpoint_id}. Pending deliveries are suppressed and signing ends. See Delete an endpoint.
  • API keys. Revoke each key from Developers > API keys, or with POST /v1/api-keys/{api_key_id}/revoke. A revoked key stops working at once. See API key security.
  • CLI sessions. Revoke them from Developers > CLI sessions, or run flint logout --confirm on each machine. See Flint CLI.
  • Connected apps. Remove the apps you installed from Settings > Connected apps. Revoking an install also revokes the API keys and deletes the webhook endpoints linked to it.
  • Teammates. Remove each one from Settings > Team. They lose access at once. You can't remove your own access, so keep it until Flint closes the account.

8. Ask Flint support to close the account#

Open a private question in Flint Help: Close my account. Say:

  • the business name and the merchant ID (mer_...) from Settings > Business profile;
  • that you have stopped selling, canceled every subscription, and received your last payout;
  • whether you pay Flint for a plan or the custom domain add-on, so those charges can be handled too.

When Flint support closes the account, status on GET /v1/merchant becomes closed. See Account status.

Next steps#

Was this helpful?