Customer Management
The Customers API lets you create records, list with filters, and retrieve by ID. Customer tags power funnel segmentation together with device and geo enrichment.Create a customer
List with filters
The list shows only activated customers. A customer is activated when their first order, payment, or subscription is created; a successful payment is not required. Creating a customer alone does not include it in the list. Usetagada.customers.retrieve(customer.id) to read the record before activation.
storeIds, firstName, lastName, email, paymentInstrumentCardLast4, and tags. Use page, pageSize, and sortBy for pagination and ordering.
Retrieve one customer
Tags and funnel conditions
Funnel edges can branch on customer tags, geo/device signals, and related predicates. Typical tag- and profile-driven conditions include:Express conditions in funnel edge
conditions.when objects the same way as in the Upsell & downsell funnel tutorial (e.g. { when: { 'customer.hasTag': { tag: 'vip' } } }).Auto-enriched tags
During funnel/checkout flows, TagadaPay can merge device and geo tags (and UTM-style tags from the device) onto the customer, for example:SDK methods reference
Next steps
Checkout sessions
Pre-loaded carts and
customerTags on session linksUpsell & downsell funnel
Example conditions using tags and order context
Block rules
Block risky traffic and instruments at the account level
Merchant quick start
Full SDK walkthrough from processor to checkout
