> For the complete documentation index, see [llms.txt](https://developer.smarts.ee/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.smarts.ee/integration/spring-boot-starter/loyalty-cards.md).

# Loyalty cards

{% hint style="info" %}
Implementation is **OPTIONAL**
{% endhint %}

### General Flow

* Smarts shows available loyalty cards in app.
* Client will select card and fill required fields to link loyalty cards.
* Merchant will verify loyalty card and send loyalty card information to Smarts
* Smarts will send loyalty card information along with request to get client based prices and offers.
* Bonus point system can be used in app and payment process.

### Configuration

* **Create and configure new loyalty card in Smarts manager UI.**
  * Choose loyalty card type (Default, Bonus, ... etc)
  * Choose stores where this card can be used
  * Choose validation methods.
    * Currently available: identification code, card number,  phone, email
* **Implement required SDK methods for loyalty card verification**

### Implementation

You only need to create a new class, implement **`LoyaltyCardAdapter`** interface and fill all required methods.  API endpoints for loyalty card services are created automatically and secured with token. 

It is important to add `@Component` annotation on top of the class. There is no restriction for class name or location in your project. Our SDK will find your implementation based on the interface (DI).

```java
import ee.smarts.common.v1.Exceptions.LoyaltyCardException;
import ee.smarts.common.v1.requests.LoyaltyCardBonusRequest;
import ee.smarts.common.v1.requests.LoyaltyCardRegistrationRequest;
import ee.smarts.common.v1.responses.LoyaltyCardBonusResponse;
import ee.smarts.common.v1.responses.LoyaltyCardRegistrationResponse;
import ee.smarts.starter.adapter.LoyaltyCardAdapter;
import org.springframework.stereotype.Component;

@Component
public class LoyaltyCardAdapterImpl implements LoyaltyCardAdapter {

    @Override
    public LoyaltyCardRegistrationResponse register(LoyaltyCardRegistrationRequest request) throws LoyaltyCardException {
        // implement this method
        return null;
    }

    @Override
    public LoyaltyCardBonusResponse getLoyaltyCardBonus(LoyaltyCardBonusRequest request) throws LoyaltyCardException {
        // implement this method
        return null;
    }
}

```