---
updatedAt: 2025-11-17T20:49:31.000Z
agentTools:
  projectIndex: https://developers.bluesnap.com/v8976-Extended/llms.txt
---

# shopper-contact-info

### Request

<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Property Name
      </th>

      <th style={{ textAlign: "left" }}>
        Type
      </th>

      <th style={{ textAlign: "left" }}>
        Required
      </th>

      <th style={{ textAlign: "left" }}>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        `title`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Shopper's title.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `first-name`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        **Required**
      </td>

      <td style={{ textAlign: "left" }}>
        Shopper's first name.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `last-name`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        **Required**
      </td>

      <td style={{ textAlign: "left" }}>
        Shopper's last name (family name).
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `email`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        **Required**
      </td>

      <td style={{ textAlign: "left" }}>
        Shopper's email address.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `company-name`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Name of shopper's company.  
        Maximum 50 characters.

        **Note:** Required, if payment type is ECP and `account-type` is:

        * CORPORATE_CHECKING

        * CORPORATE_SAVINGS
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `address1`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        **Required**
      </td>

      <td style={{ textAlign: "left" }}>
        First line of the shopper's address. Maximum 100 characters.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `address2`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Second line of the shopper's address. Maximum 100 characters.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `city`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        **Required**
      </td>

      <td style={{ textAlign: "left" }}>
        Shopper's city.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `state`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Shopper's state code.  
        See [State and province codes](https://developers.bluesnap.com/v8976-Basics/reference/state-and-province-codes).  
        Supports US and Canada states only. For states in other countries, it is necessary to include the state in the address property.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `zip`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        **Required**
      </td>

      <td style={{ textAlign: "left" }}>
        Shopper's ZIP code.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `country`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        **Required**
      </td>

      <td style={{ textAlign: "left" }}>
        Shopper's country code.  
        See [Country codes](https://developers.bluesnap.com/v8976-Basics/reference/country-codes).
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `phone`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        **Required**
      </td>

      <td style={{ textAlign: "left" }}>
        Shopper's phone number.

        Between 2-36 characters.  
        Accepts numbers, letters, and these characters: **+ . * # / \ ( ) -**
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `fax`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Shopper's fax number.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        `personal-identification-number`
      </td>

      <td style={{ textAlign: "left" }}>
        _string_
      </td>

      <td style={{ textAlign: "left" }}>
        **Required** for [local LatAm processing](https://developers.bluesnap.com/v8976-Basics/reference/latam-local-processing) in Brazil; Optional for all other Latam countries.
      </td>

      <td style={{ textAlign: "left" }}>
        The shopper's local personal identification number. These are the ID types per country:

        * Argentina - DNI (length 7-11 chars)
        * Brazil - CPF/CNPJ (length 11-14 chras)
        * Chile - RUN (length 8-9 chars)
        * Colombia - CC (length 6-10 chars)
        * Mexico - CURP/RFC (length 10-18 chars)
      </td>
    </tr>
  </tbody>
</Table>

### Response

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Property Name
      </th>

      <th>
        Type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `title`
      </td>

      <td>
        _string_
      </td>

      <td>
        Shopper's title.
      </td>
    </tr>

    <tr>
      <td>
        `first-name`
      </td>

      <td>
        _string_
      </td>

      <td>
        Shopper's first name.
      </td>
    </tr>

    <tr>
      <td>
        `last-name`
      </td>

      <td>
        _string_
      </td>

      <td>
        Shopper's last name (family name).
      </td>
    </tr>

    <tr>
      <td>
        `email`
      </td>

      <td>
        _string_
      </td>

      <td>
        Shopper's email address.
      </td>
    </tr>

    <tr>
      <td>
        `company-name`
      </td>

      <td>
        _string_
      </td>

      <td>
        Shopper's company name.
      </td>
    </tr>

    <tr>
      <td>
        `address1`
      </td>

      <td>
        _string_
      </td>

      <td>
        First line of the shopper's address. Maximum 100 characters.
      </td>
    </tr>

    <tr>
      <td>
        `address2`
      </td>

      <td>
        _string_
      </td>

      <td>
        Second line of the shopper's address. Maximum 100 characters.
      </td>
    </tr>

    <tr>
      <td>
        `city`
      </td>

      <td>
        _string_
      </td>

      <td>
        Shopper's city.
      </td>
    </tr>

    <tr>
      <td>
        `state`
      </td>

      <td>
        _string_
      </td>

      <td>
        Shopper's state code.  
        See [State and province codes](https://developers.bluesnap.com/v8976-Basics/reference/state-and-province-codes).  
        Supports US and Canada states only. For states in other countries, it is recommended to include the state in the address property.
      </td>
    </tr>

    <tr>
      <td>
        `zip`
      </td>

      <td>
        _string_
      </td>

      <td>
        Shopper's ZIP code.
      </td>
    </tr>

    <tr>
      <td>
        `country`
      </td>

      <td>
        _string_
      </td>

      <td>
        Shopper's country code.  
        See [Country codes](https://developers.bluesnap.com/v8976-Basics/reference/country-codes).
      </td>
    </tr>

    <tr>
      <td>
        `phone`
      </td>

      <td>
        _string_
      </td>

      <td>
        Shopper's phone number.
      </td>
    </tr>

    <tr>
      <td>
        `fax`
      </td>

      <td>
        _string_
      </td>

      <td>
        Shopper's fax number.
      </td>
    </tr>

    <tr>
      <td>
        `personal-identification-number`
      </td>

      <td>
        _string_
      </td>

      <td>
        The shopper's local personal identification number. These are the ID types per country:

        * Argentina - DNI (length 7-11 chars)
        * Brazil - CPF/CNPJ (length 11-14 chras)
        * Chile - RUN (length 8-9 chars)
        * Colombia - CC (length 6-10 chars)
        * Mexico - CURP/RFC (length 10-18 chars)
      </td>
    </tr>
  </tbody>
</Table>