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

# Link Customer Device

> Link a device to a customer's phrase.



## OpenAPI

````yaml POST /v1/bank/customer/device/link
openapi: 3.1.0
info:
  title: Peere Network API
  description: >-
    Comprehensive API documentation for Peere Network's payment platform,
    including Merchant, Bank, and Provider APIs
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.peere.network
    description: Production server
  - url: https://sandbox-api.peere.network
    description: Sandbox server
security:
  - bearerAuth: []
tags:
  - name: Merchant - Account Operations
    description: Merchant account management operations
  - name: Merchant - Find Customer
    description: Customer discovery and lookup operations for merchants
  - name: Merchant - Billing & Payment Operations
    description: Billing and payment processing for merchants
  - name: Merchant - Recurring Billing
    description: Subscription and recurring payment management
  - name: Merchant - Customer Decisions
    description: Customer authorization and decision management
  - name: Merchant - Refund Management
    description: Refund processing and management
  - name: Merchant - Transaction Management
    description: Transaction history and details
  - name: Merchant - Balance & Financial Operations
    description: Balance inquiries and financial operations
  - name: Merchant - Shared Operations
    description: Common operations shared across merchant services
  - name: Bank - Account Operations
    description: Bank account management operations
  - name: Bank - Customer Management
    description: Customer management for banks
  - name: Bank - Customer Device Management
    description: Device linking and management for bank customers
  - name: Bank - Customer Billing & Subscriptions
    description: Billing and subscription management for bank customers
  - name: Bank - Transaction Management
    description: Transaction processing and history for banks
  - name: Bank - Balance & Financial Operations
    description: Balance and financial operations for banks
  - name: Provider - Provider Management
    description: Provider account and profile management
  - name: Provider - Merchant Management
    description: Merchant management for providers
  - name: Provider - Merchant Trust Management
    description: Trust and verification management for merchants
  - name: Provider - Find Customer
    description: Customer discovery operations for providers
  - name: Provider - Billing Operations
    description: Billing operations on behalf of merchants
  - name: Provider - Refund Management
    description: Refund management on behalf of merchants
  - name: Provider - Recurring Billing
    description: Recurring billing management for providers
  - name: Provider - Customer Decisions
    description: Customer decision management for providers
  - name: Provider - Transaction Management
    description: Transaction management for providers
  - name: Provider - Balance & Financial Operations
    description: Balance and financial operations for providers
  - name: Provider - Shared Operations
    description: Common operations for providers
paths:
  /v1/bank/customer/device/link:
    post:
      tags:
        - Bank - Customer Device Management
      summary: Link Customer Device
      description: Link a device to a customer's phrase
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                customerId:
                  type: string
                phrase:
                  type: string
                deviceId:
                  type: string
              required:
                - customerId
                - phrase
                - deviceId
      responses:
        '200':
          description: Device linked successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
components:
  schemas:
    SuccessResponse:
      type: object
      properties:
        statusCode:
          type: integer
          example: 200
        success:
          type: boolean
          example: true
        message:
          type: string
    Error:
      type: object
      required:
        - statusCode
        - success
        - message
      properties:
        statusCode:
          type: integer
          example: 400
        success:
          type: boolean
          example: false
        message:
          type: string
          example: Bad request
  responses:
    BadRequestError:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    UnauthorizedError:
      description: Authentication required
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````