Send magic link
Public, cart-token–scoped. Sends a magic-link / MFA challenge to the
customer’s email and returns a challenge uuid (201) to submit to
POST …/auth/verify. No bearer token is required. fluid_shop here is the
company subdomain (e.g. acme). Set lookup_only: true for a
returning-buyer probe that only looks up an existing login identity —
a customer, a company membership that does not yet carry a customer
record, or (for companies on the shared Fluid Pay wallet) the wallet
itself when the email has no identity at this store yet — and never
creates one; a 404 then signals the frontend to treat the email as
a guest and skip confirmation. A membership-only or wallet-only
identity still receives a 201 challenge, and its customer record is
created when POST …/auth/verify confirms the code. Returns 410
when the cart is a locked/authorized enrollment cart and 422 on
validation errors.
Path Parameters
Cart token
Body
Customer email to send magic link to
"customer@example.com"
Company subdomain
"acme"
Returning-buyer probe. When true, only looks up an existing login identity — a customer, a membership without a customer record, or the shared Fluid Pay wallet when the email is new to this store — and never creates one; a not-found (404) tells the frontend to treat the email as a guest and skip the confirmation step.