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

# Atualizar cliente

> Atualiza os dados de um cliente específico. Nenhum campo é obrigatório, exceto quando o cliente não possui um endereço cadastrado e deseja cadastrar um novo endereço - neste caso, todos os campos do endereço são obrigatórios.



## OpenAPI

````yaml PUT /customers/{customerId}
openapi: 3.1.0
info:
  title: OpenAPI Super APIs
  description: Documentação das APIs destinada a companhias da Super Pagamentos
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://sandbox-api.superpagamentos.com
    description: Ambiente de desenvolvimento
  - url: https://api.superpagamentos.com
    description: Ambiente de produção
security: []
paths:
  /customers/{customerId}:
    put:
      description: >-
        Atualiza os dados de um cliente específico. Nenhum campo é obrigatório,
        exceto quando o cliente não possui um endereço cadastrado e deseja
        cadastrar um novo endereço - neste caso, todos os campos do endereço são
        obrigatórios.
      parameters:
        - name: customerId
          in: path
          description: Identificador único do cliente
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                firstName:
                  type: string
                  description: Nome do cliente
                  example: Pedro
                lastName:
                  type: string
                  description: Sobrenome do cliente
                  example: Alecrim
                email:
                  type: string
                  description: Email do cliente
                  example: email@email.com
                phoneNumber:
                  type: string
                  description: Número de telefone do cliente
                  example: '00000000000'
                document:
                  type: string
                  description: CPF ou CNPJ do cliente
                  example: '00000000000'
                birthdate:
                  type: string
                  format: date
                  description: Data de nascimento do cliente no formato yyyy-mm-dd
                  example: '1994-10-04'
                address:
                  type: object
                  description: >-
                    Endereço do cliente. Se o cliente não possuir um endereço
                    cadastrado, todos os campos são obrigatórios para cadastrar
                    um novo endereço.
                  properties:
                    zipcode:
                      description: CEP do endereço
                      type: integer
                      example: 87654321
                    street:
                      description: Nome da rua
                      type: string
                      example: Rua B
                    streetNumber:
                      description: Número do endereço
                      type: integer
                      example: 200
                    complement:
                      type: string
                      description: Complemento do endereço (opcional)
                      example: Casa 10
                    reference:
                      type: string
                      description: Ponto de referência do endereço (opcional)
                      example: Ao lado da padaria
                    neighborhood:
                      description: Bairro do endereço
                      type: string
                      example: Jardins
                    city:
                      description: Cidade do endereço
                      type: string
                      example: São Paulo
                    state:
                      description: Estado do endereço
                      type: string
                      example: SP
      responses:
        '200':
          description: Cliente atualizado com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                        example: cccfaed0-f346-4543-81ee-57b41db2aafa
                      firstName:
                        type: string
                        example: Pedro
                      lastName:
                        type: string
                        example: Alecrim
                      email:
                        type: string
                        example: email@email.com
                      phoneNumber:
                        type: string
                        example: '00000000000'
                      document:
                        type: string
                        example: '00000000000'
                      birthdate:
                        type: string
                        format: date
                        example: '1994-10-04'
                      address:
                        type: object
                        properties:
                          statusId:
                            type: string
                            example: APPROVED
                          zipcode:
                            type: integer
                            example: 87654321
                          street:
                            type: string
                            example: Rua B
                          streetNumber:
                            type: integer
                            example: 200
                          complement:
                            type: string
                            example: Casa 10
                          reference:
                            type: string
                            example: Ao lado da padaria
                          neighborhood:
                            type: string
                            example: Jardins
                          city:
                            type: string
                            example: São Paulo
                          state:
                            type: string
                            example: SP
                      statusId:
                        type: string
                        example: APPROVED
                      createdAt:
                        type: string
                        format: date-time
                        example: '2025-05-31T22:41:16.755Z'
                  message:
                    type: string
                    example: Cliente atualizado com sucesso
        '400':
          description: Erro na atualização do cliente
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      message:
                        type: string
                      returnCode:
                        type: integer
              examples:
                Cliente sem endereço:
                  value:
                    data:
                      message: >-
                        O cliente não possui um endereço cadastrado, para
                        cadastrar é necessário informar todos os campos do
                        endereço.
                      returnCode: -7406
                Erro não mapeado:
                  value:
                    data:
                      message: Erro ao atualizar cliente
                      returnCode: -7404
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token JWT gerado na rota de autenticação (/auth). Deve ser enviado no
        formato: Bearer <token>

````