ReceiptRoller can automatically issue a member number for each customer, per business account. The issued member number is used as a common identifier across the Wallet membership verification barcode, the CRM customer master, and POS integrations (Smaregi, Square, etc.). When a customer says "my member number is XX," store staff can identify that customer with just that one number.

This article covers the member number format, how to configure the prefix and digit count, issuance timing, the impact on existing numbers, and format validation.

Member number format

Member numbers are issued in the format "prefix + hyphen + sequential number." For example:

• SHIBUYA-00000123
• RR26-00045821
• CAFE-0001

The prefix is a unique identifier for the store (business account), and the sequential number is a digit that increments in order starting from 1 within that business account.

Configurable settings

• Prefix: alphanumeric characters, hyphens, and underscores can be used (recommended: 4-10 uppercase letters. Example: SHIBUYA, CAFE, RR26)
• Sequential number digit count: choose from 4 to 10 digits. For example, if you set the digit count to 8, the first number will start at SHIBUYA-00000001
• Starting number: normally starts at 1, but can be configured to start from a specific number (for example, when migrating from an existing paper membership card, you can start from a continuing number)

Choosing a prefix

It's convenient to choose a prefix that both customers and store staff can immediately recognize as "this is the membership card for XX store." Please refer to the following guidelines.

• English spelling of the store or brand name: STARBUCKS, UNIQLO, SHIBUYA
• Store abbreviation: use an abbreviation for long store names. SBX, UNIQ
• Region + business type: for identifying multiple stores. SHIBUYA-CAFE (the prefix can also include a hyphen)
• Brand code: an internal code used within your company. RR26, WDCB

The prefix is changeable, but changing it does not change member numbers that have already been issued (see "Behavior after changing settings" below).

Initial setup

Business accounts using ReceiptRoller for the first time have an initial prefix set automatically. The default prefix is generated by taking the first 6 alphanumeric characters of the business account name (e.g. 株式会社レシートローラー) and uppercasing them (e.g. RECEIP).

There's no issue using it as-is, but we recommend changing it to a string that matches your store's brand.

Issuance timing

A member number is issued at any of the following timings.

• When a customer registers as a member: it's issued the moment a customer registers as a member via the web app, iOS app, Android app, LINE Mini App, or storefront QR code
• When store staff manually issues one: it's issued on the spot when you press "Create New Member" from the CRM screen
• When member information is synced from the POS: when information for a customer registered as a member on the POS is synced to ReceiptRoller, a number is automatically issued if one doesn't already exist

The issued member number is immediately reflected as the barcode on the customer's Wallet membership verification.

Sequential number reliability

Member number sequential numbers are managed atomically. Even if multiple customers register as members at the same time, the sequential numbers will never be duplicated. Also, a number that has been issued once is never reused (there's no scenario where a customer withdraws and the same number gets assigned to a different customer).

This means there's no risk of a member number tied to a past receipt or POS transaction history ending up pointing to a different person.

Changing settings

You can change the prefix or digit count from the store management screen → "Store App" → "Membership Verification" → "Member Number Settings." Here's what happens after a change.

• Member numbers that have already been issued do not change. Existing numbers recorded in a customer's Wallet membership verification or CRM record stay as they are
• The new format applies starting from newly issued numbers. For example, if you change the prefix from CAFE to SHIBUYA, the next issued number will be something like SHIBUYA-00000124
• If you increase the digit count, subsequent numbers are issued with the new digit count. Example: if you change from 5 digits to 8 digits, the existing CAFE-00123 stays as-is, and the next one becomes CAFE-00000124
• Decreasing the digit count is only possible if the sequential number doesn't exceed the existing digit count. You cannot reduce to 4 digits if a 5-digit number has already been issued

Relationship with POS

Member numbers issued by ReceiptRoller are also automatically synced to the customer master of your connected POS (Smaregi, Square, etc.). Conversely, member numbers issued on the POS side are recorded as-is as the ReceiptRoller-side member number (ReceiptRoller never re-issues a new number).

For details on two-way sync, see the separate article "Two-Way Member Information Sync with Smaregi/Square."

Format validation

In situations where store staff manually enter a customer's member number (such as at a storefront without a barcode reader), you can perform a format check to see whether the entered number matches the business account's prefix and digit count pattern.

However, this is format validation only — it doesn't confirm "whether this number was actually issued by ReceiptRoller" (even if it matches the pattern, an unissued number could still be entered). For actual verification, please use the customer search in the CRM.

Setup steps

1. Open the store management screen → "Store App" → "Membership Verification" → "Member Number Settings"
2. Enter the prefix (recommended: 4-10 uppercase letters)
3. Select the sequential number digit count (4-10 digits)
4. Change the starting number if needed (default is 1)
5. A preview is displayed below (e.g. SHIBUYA-00000001, SHIBUYA-00000002...)
6. Press "Save" to apply the settings

Notes

• Japanese characters, spaces, and special symbols (!, @, #, $, etc.) cannot be used in the prefix
• If the number of registered members exceeds the digit count, it automatically results in an error (please set a digit count with margin in advance. Example: if you expect to reach 10,000+ members eventually, use 6 or more digits)
• Resetting the member number (returning the sequential number to 1) has a major impact on your business account's data integrity, so please consult our support team

Related help

• Two-Way Member Information Sync with Smaregi/Square
• Overview of Apple Wallet / Google Wallet Membership Cards
• Customer Data Management
• What Is the Store App Platform
• Back to Store Help Index