Member Identity
Overview
In Otonum, every person enrolled in a partner loyalty program is represented as a member record tied to an email address and/or phone number, and assigned a personal code at enrollment.
Email and Phone as Identifiers
A member can be identified by email, phone number, or both, depending on the enrollment data provided. Otonum accepts either for lookups. Your integration should store the identifiers provided by the member and pass them consistently.
Personal Code
A personal code is a short, human-readable identifier (for example JANE2026) generated by Otonum at enrollment. The member presents it at checkout on a loyalty card, in an app, or through manual entry.
The personal code is the primary reference key for transactional operations, including purchase submission, balance retrieval, and voucher creation.
The personal code is generated by Otonum and cannot be chosen manually. Retrieve it from the enrollment response and store it in your system. Without it, transactions cannot be submitted for that member.
To retrieve a personal code by email and to fetch a member balance, use the routes documented in the API Reference.
Member Balance
A member balance represents rewards available for redemption. Otonum returns four fields:
| Field | Description |
|---|---|
balance | Points/Cashback currently available for redemption |
balanceCashValue | The cash equivalent of the balance |
totalEarned | Cumulative amount earned since enrollment |
totalRedeemed | Cumulative amount applied to purchases |
totalReserved | Amount locked in an active voucher, pending use |
The totalReserved amount is temporarily unavailable. It is committed to a voucher that is either consumed at redemption or automatically returned to balance if the voucher expires after 30 days.
Key Points
- A member is always scoped to a single tenant. The same email can be enrolled in multiple partner programs independently.
- Each member has one wallet per merchant context. Balances are never shared across tenants.
- Enrollment requires at least email or phone, first name, last name, and language.
See Also
- Loyalty Program: Points and cashback mechanics
- Wallet & Merchant Isolation: How balances are isolated per tenant
- Integration Guide: Full checkout flow