Member cards (Secutix contacts)

Use the Secutix connector to create and update Secutix contacts, then deliver a member card pass to Apple Wallet and Google Wallet.

The Secutix connector isn’t limited to event tickets. It can also sync Secutix contacts. This unlocks a “member card in wallet” flow. The pass represents the contact and stays in sync.

What can be built

A wallet pass can be issued that behaves like a membership card:

• One pass per member (one Secutix contact).

• Barcode / QR code for identification at the venue.

• Automatic updates when contact data changes.

• Optional install/uninstall feedback written back to Secutix.

Secutix stays the source of truth for the member profile. The Wallet Crew issues and distributes the pass.

Real-world use cases

Patterns that work well in production:

• Membership renewal at the venue: scan a QR code, update the contact, refresh the pass.

• Self-service registration: members sign up from a campaign landing page.

• Staff-assisted sign-up: front-office teams use a form instead of Secutix UI.

• Consent capture: store opt-in criteria in Secutix during enrolment.

• Segmented messaging: use install status to target installed members only.

Create and update contacts from an enrolment form

Use an enrolment form in The Wallet Crew to:

• Create a new Secutix contact.

• Update an existing Secutix contact.

• Immediately deliver the member card to Apple Wallet / Google Wallet.

This works well when the Secutix UI should not be exposed to staff. It also fits self-service registration flows.

QR code entry point

Display a QR code that opens the enrolment form on a phone. This is ideal for on-site acquisition. Think foyer, ticket desk, or partner booths.

Mapping: The Wallet Crew account ↔ Secutix contact

When contact sync is enabled, The Wallet Crew maps account fields to Secutix contact fields. Customize the mapping to read or write specific Secutix criteria. This is common for consents, segmentation flags, or legacy fields.

Add the custom mapping script in the Secutix configuration Advanced tab.

Secutix configuration screen

Advanced contact mapping hook

Register extensions.secutix.contact.mapper.

• MapToSecutix(account, request) runs before calling Secutix.

• MapToNeostore(response, account) runs after Secutix responds.

/**
 * Applies enhanced mapping from neostore account data to a Secutix contact request.
 * The standard mapping is already applied on the request object before this function is called.
 *
 * @param {Object} account - Data coming from neostore.
 * @param {Object} request - Request sent to Secutix with default mapping already populated.
 */
function mapToSecutix(account, request){
  request.ExternalContactCriterionData = [{ CriterionIdCode : 'OPT_CO', Values : [account["consents_email"] ? 'true' : 'false'] }];
}

/**
 * Applies enhanced mapping from a Secutix contact response back to a neostore account.
 * The standard mapping is already applied on the account object before this function is called.
 *
 * @param {Object} response - Response received from Secutix.
 * @param {Object} account - Data sent to neostore with default mapping already populated.
 */
function mapToNeostore(response, account){
  response.ContactCriteria = response.ContactCriteria || [];
  account["consents_email"] = !!response.ContactCriteria.find(c => c.CriterionIdCode === 'OPT_CO' && c.Values != null && c.Values[0] === 'true');
}

export default function(context) {
  context.register('extensions.secutix.contact.mapper', {
    MapToSecutix : mapToSecutix,
    MapToNeostore: mapToNeostore
  });
}

Installation status update on contact

This hook persists pass install/uninstall signals into Secutix contact criteria. Use it to drive segmentation or operational reporting in Secutix.

Implement extensions.secutix.contact.passUpdater:

/**
 * Triggered when a member card installation status changes.
 *
 * @param {Object} request - Secutix SaveIndividualContactRequest.
 * @param {boolean} isInstalled - `true` if the card is installed, otherwise `false`.
 * @param {number} device - Device on which the installation status changed (0 = Apple, 2 = Google).
 * @returns {Promise<void>} No return value; modifies the request in place.
 */
async function onPassInstallationStatusChanged(request, isInstalled, device){
  request.ExternalContactCriterionData = [
    {
      CriterionIdCode : 'W_' + (device == 0 ? "APPLE" : "GOOGLE"),
      Values : [isInstalled ? 'Installé' : 'Désinstallé']
    }
  ];
}

export default function(context) {
  context.register('extensions.secutix.contact.passUpdater', {
    OnPassInstallationStatusChanged: onPassInstallationStatusChanged
  });
}