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

Onboard and manage your customers within the Peere Network ecosystem.

## What is Customer Management?

<Card title="Customer Onboarding & Management" icon="users">
  Efficiently onboard your existing customers to the Peere Network and manage their profiles, enabling them to make identity based payments.
</Card>

## Key Operations

<CardGroup cols={3}>
  <Card title="Customer Onboarding" icon="user-plus">
    Batch onboard existing customers
  </Card>

  <Card title="Profile Management" icon="user-gear">
    Update customer information and settings
  </Card>

  <Card title="Customer Lookup" icon="magnifying-glass">
    Search and retrieve customer records
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Batch Customer Creation">Onboard existing customers using batch API endpoints</Step>
  <Step title="Identity Linking">Link customer identities to their unique phrases</Step>
  <Step title="Profile Management">Maintain and update customer information</Step>
  <Step title="Payment Enablement">Enable customers to make Peere Network payments</Step>
</Steps>

### Batch Customer Onboarding

<CodeGroup>
  ```json Request theme={null}
  {
    "customers": [
      {
        "clientRef": "cust_001",
        "firstname": "John",
        "lastname": "Doe",
        "accountName": "John Doe",
        "email": "john.doe@example.com",
        "country": "NG",
        "accountNumber": "1234567890",
        "reference": "ref_001"
      }
    ]
  }
  ```

  ```bash cURL theme={null}
  curl -X POST "https://api.peere.network/v1/bank/customers" \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "customers": [
        {
          "clientRef": "cust_001",
          "firstname": "John",
          "lastname": "Doe",
          "accountName": "John Doe",
          "email": "john.doe@example.com",
          "country": "NG",
          "accountNumber": "1234567890"
        }
      ]
    }'
  ```
</CodeGroup>

### Get Customer Information

<CodeGroup>
  ```bash By ID theme={null}
  curl -X GET "https://api.peere.network/v1/bank/customers/{customerId}" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

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

## Batch Processing

<Info>The batch customer creation endpoint supports high volume processing with comprehensive validation and detailed error reporting for failed records.</Info>

<Tabs>
  <Tab title="Validation">Comprehensive data validation before processing to ensure data quality.</Tab>
  <Tab title="Error Reporting">Detailed failure reports with specific error codes for troubleshooting.</Tab>
  <Tab title="Progress Tracking">Real time status updates and completion notifications.</Tab>
</Tabs>

## Use Cases

<Tabs>
  <Tab title="Customer Migration">Migrate existing customers from legacy systems to enable Peere Network payments.</Tab>
  <Tab title="New Customer Onboarding">Streamline registration process for new customers opening accounts.</Tab>
  <Tab title="Profile Updates">Maintain accurate customer information and preferences.</Tab>
  <Tab title="Compliance Management">Ensure customer data meets regulatory requirements and audit trails.</Tab>
</Tabs>

## Data Privacy & Security

<CardGroup cols={2}>
  <Card title="Encryption" icon="lock">
    All customer data encrypted at rest and in transit
  </Card>

  <Card title="Compliance" icon="shield-check">
    GDPR, PCI DSS, and local regulatory compliance
  </Card>
</CardGroup>

<Warning>Ensure customer consent before onboarding them to the Peere Network. Customers should understand how their identity will be used for payments.</Warning>

## Customer Lifecycle

<Steps>
  <Step title="Registration">Customer opens account with your bank</Step>
  <Step title="Peere Onboarding">Add customer to Peere Network</Step>
  <Step title="Device Linking">Link customer devices for merchant interactions</Step>
  <Step title="Payment Authorization">Customer can approve merchant billing requests</Step>
</Steps>

## Next Steps

After onboarding customers:

1. [Customer Device Management](/bank-apis/customer-device-management/overview) to link customer devices
2. [Customer Billing & Subscriptions](/bank-apis/customer-billing-subscriptions/overview) to handle payment requests