Customer (Square 20.0.0.20220512 API)

java.lang.Object
- com.squareup.square.models.Customer

```
public class Customer
extends Object
```
This is a model class for Customer type.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class Customer.Builder
Class to build instances of Customer.

Nested Classes
Modifier and Type	Class and Description
`static class`	`Customer.Builder` Class to build instances of `Customer`.

Constructor Summary

Constructors
Constructor and Description
`Customer(String id, String createdAt, String updatedAt, List<Card> cards, String givenName, String familyName, String nickname, String companyName, String emailAddress, Address address, String phoneNumber, String birthday, String referenceId, String note, CustomerPreferences preferences, String creationSource, List<String> groupIds, List<String> segmentIds, Long version, CustomerTaxIds taxIds)` Initialization constructor.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(Object obj)`
`Address`	`getAddress()` Getter for Address.
`String`	`getBirthday()` Getter for Birthday.
`List<Card>`	`getCards()` Getter for Cards.
`String`	`getCompanyName()` Getter for CompanyName.
`String`	`getCreatedAt()` Getter for CreatedAt.
`String`	`getCreationSource()` Getter for CreationSource.
`String`	`getEmailAddress()` Getter for EmailAddress.
`String`	`getFamilyName()` Getter for FamilyName.
`String`	`getGivenName()` Getter for GivenName.
`List<String>`	`getGroupIds()` Getter for GroupIds.
`String`	`getId()` Getter for Id.
`String`	`getNickname()` Getter for Nickname.
`String`	`getNote()` Getter for Note.
`String`	`getPhoneNumber()` Getter for PhoneNumber.
`CustomerPreferences`	`getPreferences()` Getter for Preferences.
`String`	`getReferenceId()` Getter for ReferenceId.
`List<String>`	`getSegmentIds()` Getter for SegmentIds.
`CustomerTaxIds`	`getTaxIds()` Getter for TaxIds.
`String`	`getUpdatedAt()` Getter for UpdatedAt.
`Long`	`getVersion()` Getter for Version.
`int`	`hashCode()`
`Customer.Builder`	`toBuilder()` Builds a new `Customer.Builder` object.
`String`	`toString()` Converts this Customer into string format.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Customer
```
public Customer(String id,
                String createdAt,
                String updatedAt,
                List<Card> cards,
                String givenName,
                String familyName,
                String nickname,
                String companyName,
                String emailAddress,
                Address address,
                String phoneNumber,
                String birthday,
                String referenceId,
                String note,
                CustomerPreferences preferences,
                String creationSource,
                List<String> groupIds,
                List<String> segmentIds,
                Long version,
                CustomerTaxIds taxIds)
```
    Initialization constructor.
    
    Parameters:
    
    id - String value for id.
    
    createdAt - String value for createdAt.
    
    updatedAt - String value for updatedAt.
    
    cards - List of Card value for cards.
    
    givenName - String value for givenName.
    
    familyName - String value for familyName.
    
    nickname - String value for nickname.
    
    companyName - String value for companyName.
    
    emailAddress - String value for emailAddress.
    
    address - Address value for address.
    
    phoneNumber - String value for phoneNumber.
    
    birthday - String value for birthday.
    
    referenceId - String value for referenceId.
    
    note - String value for note.
    
    preferences - CustomerPreferences value for preferences.
    
    creationSource - String value for creationSource.
    
    groupIds - List of String value for groupIds.
    
    segmentIds - List of String value for segmentIds.
    
    version - Long value for version.
    
    taxIds - CustomerTaxIds value for taxIds.
- Method Detail
  - getId
```
public String getId()
```
    Getter for Id. A unique Square-assigned ID for the customer profile. If you need this ID for an API request, use the ID returned when you created the customer profile or call the [SearchCustomers]($e/Customers/SearchCustomers) or [ListCustomers]($e/Customers/ListCustomers) endpoint.
    
    Returns:
    
    Returns the String
  - getCreatedAt
```
public String getCreatedAt()
```
    Getter for CreatedAt. The timestamp when the customer profile was created, in RFC 3339 format.
    
    Returns:
    
    Returns the String
  - getUpdatedAt
```
public String getUpdatedAt()
```
    Getter for UpdatedAt. The timestamp when the customer profile was last updated, in RFC 3339 format.
    
    Returns:
    
    Returns the String
  - getCards
```
public List<Card> getCards()
```
    Getter for Cards. Payment details of the credit, debit, and gift cards stored on file for the customer profile. DEPRECATED at version 2021-06-16. Replaced by calling [ListCards]($e/Cards/ListCards) (for credit and debit cards on file) or [ListGiftCards]($e/GiftCards/ListGiftCards) (for gift cards on file) and including the `customer_id` query parameter. For more information, see [Migration notes](https://developer.squareup.com/docs/customers-api/what-it-does#migrate-customer-cards).
    
    Returns:
    
    Returns the List of Card
  - getGivenName
```
public String getGivenName()
```
    Getter for GivenName. The given name (that is, the first name) associated with the customer profile.
    
    Returns:
    
    Returns the String
  - getFamilyName
```
public String getFamilyName()
```
    Getter for FamilyName. The family name (that is, the last name) associated with the customer profile.
    
    Returns:
    
    Returns the String
  - getNickname
```
public String getNickname()
```
    Getter for Nickname. A nickname for the customer profile.
    
    Returns:
    
    Returns the String
  - getCompanyName
```
public String getCompanyName()
```
    Getter for CompanyName. A business name associated with the customer profile.
    
    Returns:
    
    Returns the String
  - getEmailAddress
```
public String getEmailAddress()
```
    Getter for EmailAddress. The email address associated with the customer profile.
    
    Returns:
    
    Returns the String
  - getAddress
```
public Address getAddress()
```
    Getter for Address. Represents a postal address in a country. For more information, see [Working with Addresses](https://developer.squareup.com/docs/build-basics/working-with-addresses).
    
    Returns:
    
    Returns the Address
  - getPhoneNumber
```
public String getPhoneNumber()
```
    Getter for PhoneNumber. The phone number associated with the customer profile. A phone number can contain 9–16 digits, with an optional `+` prefix.
    
    Returns:
    
    Returns the String
  - getBirthday
```
public String getBirthday()
```
    Getter for Birthday. The birthday associated with the customer profile, in RFC 3339 format. The year is optional. The timezone and time are not allowed. For example, `0000-09-21T00:00:00-00:00` represents a birthday on September 21 and `1998-09-21T00:00:00-00:00` represents a birthday on September 21, 1998.
    
    Returns:
    
    Returns the String
  - getReferenceId
```
public String getReferenceId()
```
    Getter for ReferenceId. An optional second ID used to associate the customer profile with an entity in another system.
    
    Returns:
    
    Returns the String
  - getNote
```
public String getNote()
```
    Getter for Note. A custom note associated with the customer profile.
    
    Returns:
    
    Returns the String
  - getPreferences
```
public CustomerPreferences getPreferences()
```
    Getter for Preferences. Represents communication preferences for the customer profile.
    
    Returns:
    
    Returns the CustomerPreferences
  - getCreationSource
```
public String getCreationSource()
```
    Getter for CreationSource. Indicates the method used to create the customer profile.
    
    Returns:
    
    Returns the String
  - getGroupIds
```
public List<String> getGroupIds()
```
    Getter for GroupIds. The IDs of customer groups the customer belongs to.
    
    Returns:
    
    Returns the List of String
  - getSegmentIds
```
public List<String> getSegmentIds()
```
    Getter for SegmentIds. The IDs of segments the customer belongs to.
    
    Returns:
    
    Returns the List of String
  - getVersion
```
public Long getVersion()
```
    Getter for Version. The Square-assigned version number of the customer profile. The version number is incremented each time an update is committed to the customer profile, except for changes to customer segment membership and cards on file.
    
    Returns:
    
    Returns the Long
  - getTaxIds
```
public CustomerTaxIds getTaxIds()
```
    Getter for TaxIds. Represents the tax ID associated with a [customer profile]($m/Customer). The corresponding `tax_ids` field is available only for customers of sellers in EU countries or the United Kingdom. For more information, see [Customer tax IDs](https://developer.squareup.com/docs/customers-api/what-it-does#customer-tax-ids).
    
    Returns:
    
    Returns the CustomerTaxIds
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - toString
```
public String toString()
```
    Converts this Customer into string format.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    String representation of this class
  - toBuilder
```
public Customer.Builder toBuilder()
```
    Builds a new Customer.Builder object. Creates the instance with the state of the current model.
    
    Returns:
    
    a new Customer.Builder object

Class Customer

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Customer

Method Detail

getId

getCreatedAt

getUpdatedAt

getCards

getGivenName

getFamilyName

getNickname

getCompanyName

getEmailAddress

getAddress

getPhoneNumber

getBirthday

getReferenceId

getNote

getPreferences

getCreationSource

getGroupIds

getSegmentIds

getVersion

getTaxIds

hashCode

equals

toString

toBuilder