> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peere.co/llms.txt
> Use this file to discover all available pages before exploring further.

# guides

# Customer Device Management

Link customer devices to enable seamless merchant interactions.

## What is Customer Device Management?

<Card title="Device Linking & Management" icon="mobile">
  Link your customers' devices to their unique phrases, enabling merchants to identify and interact with customers seamlessly through device fingerprinting.
</Card>

## Key Operations

<CardGroup cols={2}>
  <Card title="Link Devices" icon="link">
    Connect customer devices to their unique phrases
  </Card>

  <Card title="Manage Devices" icon="settings">
    Update and manage device associations
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Device Identification">Capture customer device fingerprint or ID</Step>
  <Step title="Phrase Association">Link device to customer's unique lookup ID</Step>
  <Step title="Merchant Discovery">Merchants can now identify customers by their devices</Step>
  <Step title="Seamless Interaction">Enable frictionless payment experiences</Step>
</Steps>

### Link Customer Device

<CodeGroup>
  ```json Request theme={null}
  {
    "customerId": "customer_123",
    "phrase": "unique-customer-phrase",
    "deviceId": "device_789"
  }
  ```

  ```bash cURL theme={null}
  curl -X POST "https://api.peere.network/v1/bank/customer/device/link" \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "customerId": "customer_123",
      "phrase": "unique-customer-phrase",
      "deviceId": "device_789"
    }'
  ```
</CodeGroup>

## Device Linking Benefits

<Tabs>
  <Tab title="Merchant Recognition">Merchants can identify returning customers automatically when they visit websites or apps.</Tab>
  <Tab title="Reduced Friction">Customers don't need to manually enter payment information or account details.</Tab>
  <Tab title="Enhanced Security">Device fingerprinting adds an additional layer of customer verification.</Tab>
  <Tab title="Better Experience">Enable one click payment experiences for your customers.</Tab>
</Tabs>

## Use Cases

<Tabs>
  <Tab title="Mobile Banking">Link customer mobile devices to enable payments through merchant apps.</Tab>
  <Tab title="Web Banking">Associate customer browsers with their accounts for web based merchant interactions.</Tab>
  <Tab title="IoT Devices">Link smart devices for automated payments in IoT scenarios.</Tab>
  <Tab title="Point of Sale">Enable device based recognition at physical merchant locations.</Tab>
</Tabs>

## Device Security

<Info>Device linking uses secure fingerprinting techniques that protect customer privacy while enabling merchant recognition. No sensitive account information is exposed to merchants.</Info>

<CardGroup cols={2}>
  <Card title="Privacy Protection" icon="shield">
    Device IDs are anonymized and encrypted
  </Card>

  <Card title="Secure Linking" icon="lock">
    Phrase associations are securely stored
  </Card>
</CardGroup>

## Device Management

<Steps>
  <Step title="Initial Linking">Link customer devices during onboarding or first use</Step>
  <Step title="Multiple Devices">Customers can link multiple devices to their account</Step>
  <Step title="Device Updates">Handle device changes and updates over time</Step>
  <Step title="Security Monitoring">Monitor for suspicious device activity</Step>
</Steps>

<Warning>Ensure customers understand and consent to device linking. Explain how their devices will be used to enable seamless payment experiences with merchants.</Warning>

## Next Steps

After implementing device management:

1. [Customer Billing & Subscriptions](/bank-apis/customer-billing-subscriptions/overview) to handle merchant payment requests
2. [Transaction Management](/bank-apis/transaction-management/overview) to monitor customer transactions