Remembered buyers
A remembered buyer is an email remembered after a checkout code. Its opaque token lets a later checkout offer another code without asking for the email. It never authorizes saved cards. See Remember a returning buyer for the flow and token storage.
The checkout lookup and revoke routes require a checkout credential. Merchant API keys are refused. Tokens travel in the request body, never in a URL, and work only at the business and in the live or sandbox environment that received them.
POST /v1/remembered-buyers/lookupreturns the masked identity.code_channelissms,email, ornull, depending on what recognition could open at this checkout. Lookup sends no code and does not check code caps.POST /v1/remembered-buyers/revokeends it. The response has no supported actions. Both "Not you?" and "Forget this device" use this operation.
Both take this body and work after the checkout ends:
{"remembered_buyer_token":"rbt_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"}
An unknown, expired, replaced, ended, or out-of-scope token returns the same 404 RESOURCE_NOT_FOUND. A repeat revoke returns 404 unless it replays the same successful idempotency key.
Create and renew an identity by sending remember_buyer: true on a successful checkout code confirmation. The response's remembered_buyer_token is a one-time secret and is omitted when remembering is unavailable. Code requests can name it instead of email, only with purpose use_saved_payment_methods, using the same recognition caps and a masked response email.
Buyer account controls#
A merchant-hosted buyer account uses a full customer session for these routes:
GET /v1/me/remembered-buyerslists working remembered buyers for the customer's current email at your business, newestlast_used_atfirst, thenremembered_buyer_iddescending. This bounded list returns every result, up to ten, without pagination.POST /v1/me/remembered-buyers/{remembered_buyer_id}/revokeforgets one remembered buyer and returns its final resource with no supported actions. Send an empty body or{}. A repeat returns404 RESOURCE_NOT_FOUNDunless it replays the same successful idempotency key.
These routes list and touch only identities remembered for your business in the customer's live or sandbox environment. They never expose or change identities remembered across stores on Flint's checkout host. code_channel is omitted from customer-session responses. Merchant API keys and customer sessions limited to a purchase cannot call these routes. There is no revoke-all route; call revoke for each item.
Notice and removal link#
Flint emails the remembered address once when a device is first remembered, including for headless checkouts and custom domains. Renewing its checkout token sends no additional notice. Remembering stays unavailable wherever the required notice email is not configured, and a successful code confirmation still succeeds without a remembered-buyer token.
The email's link opens a confirmation page on Flint's account host. Opening it changes nothing. Pressing Remove this device forgets that one device without signing in. The link works until the remembered buyer ends, including after its checkout token is renewed. Forgetting leaves saved cards saved; checkout asks for the email again on that device.
Look up a remembered buyer#
/v1/remembered-buyers/lookupRequires a checkout credential
Rate limit: read
Resolves a remembered buyer token without sending a code. Only a checkout credential can call this route, including after the checkout ends. A merchant key is refused. The email is always masked. code_channel is sms or email when this checkout can request a recognition code for the buyer, and null otherwise; it does not consider code caps. An unknown, expired, ended, replaced, other business's, or other sandbox's token returns the same 404 RESOURCE_NOT_FOUND.
Request body
remembered_buyer_tokenstringRequiredToken returned by a successful confirmation with remember_buyer. Send it only in the body.
Response · 200
The masked remembered identity.
dataobjectRequiredResource, collection, or operation result returned by this request.
code_channelenum or nullRequiredLookup only: how recognition would send a code at this checkout, without considering caps. Null when the checkout cannot request a code or has nothing saved to open.
emailsmsnull
created_atstringRequiredWhen the buyer was first remembered on this device.
emailstringRequiredAlways masked to the first character and domain, such as m•••@gmail.com.
expires_atstringRequired90 days after the last confirmed code. Lookups and code requests do not renew it.
last_used_atstringRequiredWhen a code was last confirmed on the device or requested from it.
remembered_buyer_idstringRequiredID of the remembered identity. Token replacement keeps this ID.
supported_actionsarray of enumRequiredContains revoke while the identity works; empty in a revoke response.
revoke
metaobjectAdditional information about this response.
api_versionstringAPI version used to produce this response.
idempotency_replayedbooleanWhether this response replays a stored result for the supplied Idempotency-Key.
trace_idstringTrace identifier to include when contacting Flint about this request.
warningsarray of objectConditions that need attention even though the request succeeded.
request_idstringRequiredIdentifier of this API request, used to correlate logs and support requests.
curl -X POST https://api.withflintpay.com/v1/remembered-buyers/lookup \
-H "Flint-Version: 2026-09-07" \
-H "Authorization: Bearer YOUR_CHECKOUT_AUTH_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"remembered_buyer_token": "rbt_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
}'Forget a remembered buyer#
/v1/remembered-buyers/revokeIdempotentRequires a checkout credential
Rate limit: sensitive_write
Ends the remembered identity named by the body token and returns its final masked resource with no supported actions. Only a checkout credential can call this route, including after the checkout ends. A repeat without an idempotency replay returns 404 RESOURCE_NOT_FOUND. Forgetting never changes saved cards.
Request body
remembered_buyer_tokenstringRequiredToken returned by a successful confirmation with remember_buyer. Send it only in the body.
curl -X POST https://api.withflintpay.com/v1/remembered-buyers/revoke \
-H "Flint-Version: 2026-09-07" \
-H "Authorization: Bearer YOUR_CHECKOUT_AUTH_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: a-unique-key" \
-d '{
"remembered_buyer_token": "rbt_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
}'Was this helpful?