Log In Sign Up
This method may be used to add new beneficial owner information when the original account boarding call included OwnerCount, but did not include all owner data.

Note: to change existing owner data, please contact ProPay Underwriting.
How to call this method?
Example Request
Example Response
Implementation Details
Request Submission
Response Handling
Request Submission
Response Handling
Request Submission
Response Handling
Request Submission
Response Handling
Request Values
Response Values
How to call this method?
You should submit a post of XML data to the following URL
 
HTTP URL(s) https://xmltest.propay.com/api/propayapi.aspx
Example Request
Example Response
<?xml version='1.0'?>
<!DOCTYPE Request.dtd>
<XMLRequest>
  <certStr>My certStr</certStr>
  <termid>termid</termid>
  <class>partner</class>
  <XMLTrans>
    <transType>44</transType>        
    <accountNum>123456</accountNum>
    <BeneficialOwnerData>
      <Owners>
        <Owner>
          <FirstName>First1</FirstName>
          <LastName>Last1</LastName>
          <Title>CEO</Title>
          <Address>XYZ</Address>
          <Percentage>10</Percentage>
          <SSN>123545677</SSN>
          <Country>USA</Country>
          <State>UT</State>
          <City>Lehi</City>
          <Zip>84010</Zip>
          <Email>abc@qamail.com</Email>
          <DateOfBirth>11-11-1988</DateOfBirth>
        </Owner>
      </Owners>
    </BeneficialOwnerData>
  </XMLTrans>    
</XMLRequest>
 
<XMLResponse>
  <XMLTrans>
    <transType>44</transType>
    <accountNum>123456</accountNum>
    <status>00</status>
    <beneficialOwnerDataResult>
      <Owner>
        <FirstName>First1</FirstName>
        <LastName>Last1</LastName>
        <Status>NotValidated</Status>
      </Owner>
    </beneficialOwnerDataResult>
  </XMLTrans>
</XMLResponse>
 
Implementation Details
Request Submission
Response Handling
Request Submission
Response Handling
Request Submission
Response Handling
Request Submission
Response Handling
Request Values

Element

Type

Max

Required

Notes

accountNum

Int(32)

 

Required

Assigned to each account by ProPay

BeneficialOwnerData

-

-

-

-
BeneficialOwnerData - - - -
Owners.Owner - - - -

Owners.Title

String

55

Required

 This field contains the Owner's title

Owners.FirstName

String

20

Required

Owner First name

Owners.LastName

String

25

Required

Owner Last Name  
Owners.Email String 55  Required  Owner Email ID 
Owners.DateOfBirth String   Required  Date of Birth of the Owner. Must be in 'mm-dd-yyyy' format 
Owners.Percentage String 3  Required Percentage stake in company by owner. Must be whole number between 0 and 100
Owners.Address String 100 Required Street address where Owner resides  
Owners.SSN String 9  Required Social Security Number of Owner. Should be 9 digits  
Owners.City String 55  Required The name of hte city where the Owner resides  
Owners.Zip String 10  Required The postal code where the Owner resides  
Owners.State String 3  Required The region code that corresponds to the state where Owner resides  
Owners.Country String 3  Required The three-character, alfpha country code where Owner resides  

 

Response Values

Element

Type

Notes
transType   string Will always return as 44  

status  

string

Result of the transaction request. See Propay Appendix for result code definitions
beneficialOwnerDataResult   BeneficialOwnerDataResult   The validation results for each beneficial owner provided  
How to call this method?
Example Request
Example Response
Implementation Details
Request Submission
Response Handling
Request Submission
Response Handling
Request Submission
Response Handling
Request Submission
Response Handling
Request Values
Response Values
Just take me to the API docs