> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mangopay.com/api-reference/client/client-object/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server.

# The Client object

### Description

The Client object represents your platform. There is one client object per `ClientId`.

### Attributes

### Schema (`ClientResponse`)

```yaml
components:
  schemas:
    Address:
      type: object
      properties:
        AddressLine1:
          type: string
          description: The first line of the address.
        AddressLine2:
          type: string
          description: The second line of the address.
        City:
          type: string
          description: The city of the address.
        Region:
          type: string
          description: Required if `Country` is US, CA, or MX. The region of the address.
        PostalCode:
          type: string
          description: >-
            The postal code of the address. The postal code can contain the
            following characters: alphanumeric, dashes, and spaces.
        Country:
          type: string
          description: >-
            Format: Two-letter country code ([ISO 3166-1 alpha-2
            format](/api-reference/overview/data-formats))


            The country of the address.
      description: The postal address.
      title: Address
    ClientResponsePlatformCategorization:
      type: object
      properties:
        BusinessType:
          type: string
          description: The business type of the platform.
        Sector:
          type: string
          description: The sector of activity of the platform.
      description: >-
        The categorization of the platform in terms of business and sector of
        activity.
      title: ClientResponsePlatformCategorization
    ClientResponse:
      type: object
      properties:
        PlatformType:
          type: string
          description: >-
            Type of the platform. This field has been replaced by the
            `PlatformCategorization` object.
        ClientId:
          type: string
          description: >-
            The unique identifier associated with the API key, giving access to
            either the Sandbox or Production environment.
        Name:
          type: string
          description: >-
            The trading name of the company operating the platform, shown on
            Mangopay-hosted webpages such as the [SCA
            session](/guides/sca/factors#customization) and the [hosted KYC/KYB
            session](/guides/users/verification/hosted#branding).
        RegisteredName:
          type: string
          description: The registered legal name of the company operating the platform.
        TechEmails:
          type: array
          items:
            type: string
          description: >-
            Format: Emails must be ≤ 40 characters


            List of email addresses to contact the platform for technical
            matters. Important: If the email length exceeds 40 characters, it
            will be be impossible to process some payments.
        AdminEmails:
          type: array
          items:
            type: string
          description: >-
            List of email addresses to contact the platform for administrative
            or commercial matters.
        BillingEmails:
          type: array
          items:
            type: string
          description: List of email addresses to contact the platform for billing matters.
        FraudEmails:
          type: array
          items:
            type: string
          description: >-
            List of email addresses to contact the platform for fraud and
            compliance matters.
        HeadquartersAddress:
          $ref: '#/components/schemas/Address'
        HeadquartersPhoneNumber:
          type: string
          description: >-
            Max. length: 15 characters; international telephone numbering plan
            E.164 (+ followed by the country code, then the number)


            The phone number of the platform operator's headquarters.
        TaxNumber:
          type: string
          description: The tax (or VAT) number for the company operating the platform.
        PlatformCategorization:
          $ref: '#/components/schemas/ClientResponsePlatformCategorization'
          description: >-
            The categorization of the platform in terms of business and sector
            of activity.
        PlatformURL:
          type: string
          description: The URL of the platform's website.
        PlatformDescription:
          type: string
          description: |-
            Max. length: 2,000 characters

            The description of what the platform does.
        CompanyReference:
          type: string
          description: >-
            The unique reference for the platform, which should be used when
            contacting Mangopay.
        PrimaryThemeColour:
          type: string
          description: >-
            Format: Hex color code


            The color used in accent highlights and icon elements on
            Mangopay-hosted webpages, such as for
            [SCA](/guides/sca/factors#customization) and [hosted
            KYC/KYB](/guides/users/verification/hosted#branding).
        PrimaryButtonColour:
          type: string
          description: >-
            Format: Hex color code


            The color used for call-to-action (CTA) buttons on Mangopay-hosted
            webpages, such as for [SCA](/guides/sca/factors#customization) and
            [hosted KYC/KYB](/guides/users/verification/hosted#branding).
        Logo:
          type: string
          description: The URL of the platform's logo.
        CompanyNumber:
          type: string
          description: >-
            The registration number of the company operating the platform,
            assigned by the relevant national authority.
        MCC:
          type: string
          description: >-
            4-digit merchant category code. The MCC is used to classify a
            business by the types of goods or services it provides.
        Licensor:
          type: string
          description: >-
            Possible values: `EU`, `UK`


            The licensor of the platform's company account, indicating the
            Mangopay entity the platform contracted with:

            - `EU` – Mangopay S.A.

            - `UK` – Mangopay U.K. Ltd.
      title: ClientResponse
```