Create Ultimate Beneficial Owner

CreateUltimateBeneficialOwner

How it works

By calling this method, you will link an Ultimate Beneficial Owner into a legal payment account. All Legal accounts need to provide their Ultimate Beneficial Owner information in order to be validated.

XML

<CreateUltimateBeneficialOwner xmlns="Service_mb">
   <wlLogin>string</wlLogin>
   <wlPass>string</wlPass>
   <wallet>string</wallet>
   <firstName>string</firstName>
   <lastName>string</lastName>
   <nationality>string</nationality>
   <dateOfBirth>string</dateOfBirth>
   <cityOfBirth>string</cityOfBirth>
   <countryOfBirth>string</countryOfBirth>
   <countryOfResidence>string</countryOfResidence>
   <language>string</language>
   <version>string</version>
   <walletIp>string</walletIp>
   <walletUa>string</walletUa>
</CreateUltimateBeneficialOwner>

<CreateUltimateBeneficialOwnerResponse xmlns="Service_mb">
   <CreateUltimateBeneficialOwnerResult>
     <ULTIMATEBENEFICIALOWNERID>string</ULTIMATEBENEFICIALOWNERID>
   </CreateUltimateBeneficialOwnerResult>
</CreateUltimateBeneficialOwnerResponse>

JSON

{
"CreateUltimateBeneficialOwnerInput": {
    "wlLogin": "string",
    "wlPass": "string",
    "wallet": "string",
    "firstName": "string",
    "lastName": "string",
    "nationality": "string",
    "dateOfBirth": "string",
    "cityOfBirth": "string",
    "countryOfBirth": "string",
    "countryOfResidence": "string",
    "language": "string",
    "version": "string",
    "walletIp": "string",
    "walletUa": "string"
    }
}

{
  "CreateUltimateBeneficialOwnerResponse": {
    "CreateUltimateBeneficialOwnerResult": { "ULTIMATEBENEFICIALOWNERID": "string" }
  }
}

Item	Description	Mandatory	Format	Example
wallet	Wallet ID of the legal payment account	Yes	[1:100] char	33612345678
firstName	Ultimate Beneficial Owner's first name	Yes	[2:256] char	Pierre
lastName	Ultimate Beneficial Owner's last name	Yes	[2:256] char	Dupont
nationality	Ultimate Beneficial Owner's Nationality, using ISO-3 format.	No	[0:19] char	FRA, USA
	Please separate multiple nationalities with a comma.
dateOfBirth	Ultimate Beneficial Owner's birthdate	Yes	dd/mm/yyyy	21/03/1985
cityOfBirth	Ultimate Beneficial Owner's city of birth	Yes	[0:140] car	Montreuil
countryOfBirth	Ultimate Beneficial Owner's country of birth using ISO-3	Yes	[3] char	FRA
countryOfResidence	Ultimate Beneficial Owner's country of residence using ISO-3	No	[3] char	FRA