
Customer base
Continuous and direct interaction strengthens your connection with the customer. That's why MARTA offers a range of Customer APIs that allow you to create and provide customers with a personal area, displaying their personal data, current promotions, news, and all the features your loyalty strategy supports.
Customer APIs are divided into two categories: one for general operations (handling data and activities of the authenticated customer), and one for registration and verification before logging in to the reserved area.
Learn how to access the Customer API.
Creating a dedicated customer space is a valuable resource. When used alongside the capabilities of the Backoffice APIs, it enables a more effective, robust, and customer-focused loyalty strategy.
Discover what you can do with the Backoffice APIs.
Approfondisci:
Onboarding flow refers to the process of registering a new customer or allowing access for an existing one.
For a customer who is already registered, simply use the customer access type by entering the credentials provided by the user.
During registration, however, using the customersynchro authentication, you can define whether the customer already has a Card or if a new one needs to be created.
You can retrieve information about the required personal data fields, both static and dynamic, that must be collected during data entry.
Additionally, you can manage the customers' consents, geolocation, preferences, and all other details related to the campaign on which the new Card is being activated.
You can also verify whether the customer is already registered and allow them to access their private area.
Learn more about how to build a complete Onboarding flow using the Customer APIs
With Customer access, you can manage various types of interactions between the user and their private area, ranging from viewing personal and activity-related data to executing specific actions.
Within the private area, you can manage brand-related loyalty features such as news, rewards, promotions, vouchers, cards, and badges.
Using Customer APIs, you can display these features along with their status, track which items have been read, viewed, or saved by the customer, and enable specific interactions depending on the feature type.
In the customersynchro access section, you also have dedicated endpoints that allow you to detect stores associated with your campaign based on geolocation data, but only if the user has given consent.
Still within the customer section, you can use GET and POST calls to retrieve the customer's list of favorite stores and allow them to set a preferred store.
For campaign-related actions, the Customer APIs let you display active news and track if it's been read, show past movement history, view clusters the customer belongs to and highlight promotions and InstantWin contests reserved for that customer.
You can also manage the required consents and send push notifications, registering which ones have been read.
Finally, you can display all relevant data related to requested, delivered, and available rewards, as well as shipping and exchange information entered by the customer.
See the full guide on how to build a complete customer private area using the Customer APIs.
The customer profile is defined by a combination of personal data, consent settings, recorded activities, and the actions that can be performed on this information
Personal Data Management
You can retrieve and display the customer's personal details, preferences, contact information, and consents.
These details, particularly contact data, can be verified, modified, or reset according to the customer's preferences.
Movement ManagementThe list of customer's movements, along with detailed information such as relative type, the store or network where they were performed, associated promotions, and any resulting rewards, is easily accessible via Customer APIs.
PATCH calls are available to manage the modification or reset of the customer's Pincode, as well as to perform point redemptions and credit redemptions using the Pincode Credit feature. It's important to note that these values are unique to each customer.
Profile deletion
To ensure data is handled in accordance with the highest security standards, a DELETE endpoint is provided that allows the customer to safely delete their account, including all associated data, from the system.
With Customer access, dedicated endpoints are available to generate OTP codes for verification and to send emails for resetting, modifying, or recovering a customer's password or username.