Skip to main content

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

Supported filters include 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:
Exact sets depend on available device data and enrichment settings. Custom query parameters can also become tags when wildcard mapping is enabled on your project.

SDK methods reference


Next steps

Checkout sessions

Pre-loaded carts and customerTags on session links

Upsell & 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