Skip to content

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/lookup returns the masked identity. code_channel is sms, email, or null, depending on what recognition could open at this checkout. Lookup sends no code and does not check code caps.
  • POST /v1/remembered-buyers/revoke ends 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:

JSON
{"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-buyers lists working remembered buyers for the customer's current email at your business, newest last_used_at first, then remembered_buyer_id descending. This bounded list returns every result, up to ten, without pagination.
  • POST /v1/me/remembered-buyers/{remembered_buyer_id}/revoke forgets one remembered buyer and returns its final resource with no supported actions. Send an empty body or {}. A repeat returns 404 RESOURCE_NOT_FOUND unless 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.

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#

POST/v1/remembered-buyers/lookup

Requires 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_tokenstringRequired

Token returned by a successful confirmation with remember_buyer. Send it only in the body.

Response · 200

The masked remembered identity.

dataobjectRequired

Resource, collection, or operation result returned by this request.

metaobject

Additional information about this response.

request_idstringRequired

Identifier 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#

POST/v1/remembered-buyers/revokeIdempotent

Requires 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_tokenstringRequired

Token returned by a successful confirmation with remember_buyer. Send it only in the body.

Response · 200

The masked remembered identity.

Same response as Look up a remembered buyer.

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?