Contact Data

Special Notes:

• Int ContactDataCounter is a number of contact data slots.
• Str ContactDataSlot_N identifies a customer account on behalf of which the order is placed. Contact data are submitted as strings in the following format: <ContactDataSlotName>=<ContactDataSlotValue>.

  Where:

  • <ContactDataSlotName> is a name of a contact data slot.
  • <ContactDataSlotValue> is a value of a contact data slot.

Billing supports the following contact data slots (they are validated by fraud screening):

• New Customer:
  • LoginID is a login to control panel.
  • PasswordID is a password to control panel.
  • CurrencyID is a currency for a new account.
  • FullyRegistred is a parameter that indicates whether a customer completed a full registration; possible values are 0 (no) and 1 (yes).
  • CompanyNameID is a company name for a business account, or a first name and last name for personal accounts (a personal account is created if the field is empty).
  • CompanyNameLatinID is a CompanyNameID in ASCII charset (for international use).
  • PostAddressID is a free-form postal address.
  • TaxRegID is a customer's tax registration ID; it must be specified if a Tax Registration number is required.
  • CustomerClassID is an ID of a Customer Class for an account.
  • FirstNameID is a customer's first name.
  • MiddleNameID is a customer's middle name.
  • LastNameID is a customer's last name.
  • AddressID is a first address line.
  • Address2ID is a second address line.
  • CityID is a customer's city.
  • ZipID is a customer's ZIP or postal code.
  • CountryID is a customer's country.
  • StateID is a customer's state or province.
  • EmailID is a customer's email address.
  • PhoneCountryID is a customer's phone country code.
  • PhoneAreaID is a customer's phone area code.
  • PhoneNumberID is a customer's phone number.
  • PhoneExtensionID is a customer's phone number extension.
  • FaxCountryID is a customer's fax country code.
  • FaxAreaID is a customer's fax area code.
  • FaxNumberID is a customer's fax number.
  • FaxExtensionID is a customer's fax number extension.
  • BannerID is an ID of a banner campaign configured in the Billing.
  • PromoCodeID is a promotion code, if exists.
  • SalesPersonID is a sales person ID assigned to an account.
  • SalesBranchID is a sales branch ID assigned to an account.

    Note: Each additional attribute you create becomes contact data slot and can be passed among others.

• Existing Customer:
  • AccountID is an ID of an existing account.
  • PromoCodeID is a promotion code, if exists.

New Customer Example:

<!-- ContactDataCounter -->
<value>
    <i4>24</i4>
</value>
<!-- Login to CP -->
<value>LoginID=test123</value>
<!-- Password to CP -->
<value>XXXPasswordID=123test</value>
<!-- Customer's description -->
<value>CompanyNameID=John Smith</value>
<!-- First Name -->
<value>FirstNameID=John</value>
<!-- Middle Name -->
<value>MiddleNameID=Shawn</value>
<!-- Last Name -->
<value>LastNameID=Smith</value>
<!-- Address (line 1/2) -->
<value>AddressID=Sunrise Valley Drive</value>
<!-- Address (line 2/2) -->
<value>Address2ID=Suite 600</value>
<!-- City -->
<value>CityID=New York</value>
<!-- State -->
<value>StateID=NY</value>
<!-- Zip code -->
<value>ZipID=12345</value>
<!-- Country -->
<value>CountryID=us</value>
<!-- Email -->
<value>EmailID=jsmith@tailor.com</value>
<!-- Phone country code -->
<value>PhoneCountryID=1</value>
<!-- Phone area code -->
<value>PhoneAreaID=201</value>
<!-- Phone number -->
<value>PhoneNumberID=4568523</value>
<!-- Phone Extension -->
<value>PhoneExtensionID=245</value>
<!-- Fax country code -->
<value>FaxCountryID=1</value>
<!-- Fax area code -->
<value>FaxAreaID=201</value>
<!-- Fax number -->
<value>FaxNumberID=4568523</value>
<!-- Fax Extension -->
<value>FaxExtensionID=235</value>
<!-- Promo code -->
<value>PromoCodeID=promo895</value>
<!-- Sales Person ID-->
<value>SalesPersonID=1102</value>
<!-- Sales Branch ID-->
<value>SalesBranchID=1</value>

Existing Customer Example:

<!-- ContactDataCounter -->
<value>
    <i4>2</i4>
</value>
<!-- Promo code -->
<value>PromoCodeID=promo895</value>
<!-- Customer's Account ID -->
<value>AccountID=1000002</value>