Update Legal Entity

Return to the list of PayFac® API examples

You can update the several items associated with a Legal Entity. To update information associated with a Legal Entity, you submit a legalEntityUpdateRequest message with the appropriate legalEntityId and the updated information.

You can update the following items:

•   streetAddress1 (entity and/or principal)
•   streetAddress2 (entity and/or principal)
•   city (entity and/or principal)
•   stateProvince (entity and/or principal)
•   postalCode (entity and/or principal)
•   doingBusinessAs
•   annualCreditCardSalesVolume
•   hasAcceptedCreditCards
•   contactPhone (entity and/or principal)
•   title (principal)
•   emailAddress (principal)
•   firstName (principal)
•   lastName (principal)
•   ssn (principal)
•   dateOfBirth (principal)
•   driversLicense (principal)
•   driversLicenseState (principal)
•   legalEntityName
•   legalEntityType
•   taxId
•   yearsInBusiness

PUT parameters

Example: Update Legal Entity Request

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
     <legalEntityUpdateRequest xmlns="
http://psp.litle.com/api/merchant/onboard
">

          <address>
               <streetAddress1>LE Street Address 1</streetAddress1>
               <streetAddress2>LE Street Address 2</streetAddress2>
               <city>LE City</city>
               <stateProvince>MA</stateProvince>
               <postalCode>01730</postalCode>
               <countryCode>USA</countryCode>
          </address>
          <contactPhone>9785550101</contactPhone>
          <doingBusinessAs>Other Name Co.</doingBusinessAs>
          <annualCreditCardSalesVolume>10000000</annualCreditCardSalesVolume>
          <hasAcceptedCreditCards>true</hasAcceptedCreditCards>
          <principal>
               <title>CEO</title>
               <emailAddress>
jdoe@mail.net
</emailAddress>

               <contactPhone>9785551234</contactPhone>
               <address>
                    <streetAddress1>p street address 1</streetAddress1>
                    <streetAddress2>p street address 2</streetAddress2>
                    <city>Boston</city>
                    <stateProvince>MA</stateProvince>
                    <postalCode>01890</postalCode>
                    <countryCode>USA</countryCode>
               </address>
               <backgroundCheckFields>
                    <firstName>p first</firstName>
                    <lastName>p last</lastName>
                    <ssn>123459876</ssn>
                    <dateOfBirth>1980-10-12</dateOfBirth>
                    <driversLicense>892327409832</driversLicense>
                    <driversLicenseState>MA</driversLicenseState>
               </backgroundCheckFields>
          </principal>
          <backgroundCheckFields>
               <legalEntityName>Company Name</legalEntityName>
               <legalEntityType>LE Type Enum</legalEntityType>
               <taxId>123456789</taxId>
          </backgroundCheckFields>
          <yearsInBusiness>10</yearsInBusiness>
     </legalEntityUpdateRequest>

Update Legal Entity Response

The system replies to an Update Legal Entity request with a generic response message. The structure of the response message is as follows:

<legalEntityResponse>
     <transactionId>1234567890123456789</transactionId>
     <legalEntityId> (appears if first request of dupe with all matching data)
     <responseCode>
     <responseDescription>
     <originalLegalEntity> (appears if dupe)
     <backgroundCheckResults> (appears if background check triggered by update)
</legalEntityResponse>

See Status codes and error messages

Next: Retrieve legal entity

Return to list of PayFac API examples