> ## 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

# Find Customer

Discover customers within the Peere Network to enable seamless payment experiences.

## What is Find Customer?

<Card title="Customer Discovery" icon="magnifying-glass">
  Find Customer allows merchants to identify customers and their associated banks before initiating payments, reducing friction and enabling better user experiences.
</Card>

## Key Operations

<CardGroup cols={2}>
  <Card title="Email Lookup" icon="envelope">
    Find banks associated with a customer's email address
  </Card>

  <Card title="Device Lookup" icon="mobile">
    Identify returning customers through device fingerprinting
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Customer Discovery">Use email or device ID to find customer bank associations</Step>
  <Step title="Bank Identification">Receive list of banks where customer has accounts</Step>
  <Step title="Payment Setup">Use discovered information to streamline payment flow</Step>
</Steps>

### Email Based Discovery

<CodeGroup>
  ```json Request theme={null}
  {
    "email": "customer@example.com"
  }
  ```

  ```bash cURL theme={null}
  curl -X GET "https://api.peere.network/v1/customer/banks?email=customer@example.com" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```
</CodeGroup>

### Device Based Lookup

<CodeGroup>
  ```json Request theme={null}
  {
    "deviceId": "device_12345"
  }
  ```

  ```bash cURL theme={null}
  curl -X POST "https://api.peere.network/v1/customer/device/lookup" \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"deviceId": "device_12345"}'
  ```
</CodeGroup>

## Privacy Protection

<Info>All customer data is privacy protected with masked account numbers and obfuscated names to ensure security while enabling functionality.</Info>

## Use Cases

<Tabs>
  <Tab title="Checkout Flow">During checkout, identify which banks the customer uses to show relevant payment options and reduce friction.</Tab>
  <Tab title="Returning Customers">Recognize returning customers by their devices to enable one click payment experiences.</Tab>
  <Tab title="Customer Onboarding">Verify customer bank associations during registration to set up payment preferences.</Tab>
</Tabs>

## Next Steps

After finding customers, proceed to:

1. [Billing & Payment Operations](/merchant-apis/billing-payment/overview) to process payments
2. [Customer Decisions](/merchant-apis/customer-decisions/overview) to understand authorization flows