CreateUltimateBeneficialOwner: Create an Ultimate Beneficial Owner

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.

Request


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>

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"
    }
}

Item

Description

Mandatory

Format

Example

wallet

Wallet ID of a legal payment account

Yes

[1 :100] char

33612345678

firstName

Ultimate Beneficial Owner first name

Yes

[2 :256] char

Pierre

lastName

Ultimate Beneficial Owner last name

Yes

[2 :256] char

Dupont

nationality

Nationality of the Ultimate Beneficial Owner, using ISO-3 format.
Please separate multiple nationalities with a comma.

No

[0 :19] char

FRA,USA

dateOfBirth

Ultimate Beneficial Owner birthdate

Yes

dd/MM/yyyy

21/03/1985

cityOfBirth

Ultimate Beneficial Owner city of birth

Yes

[0 :140] car

Montreuil

countryOfBirth

Ultimate Beneficial Owner country of birth using ISO-3

Yes

[3] char

FRA

countryOfResidence

Ultimate Beneficial Owner country of residence using ISO-3

No

[3] char

FRA

Response


XML

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

JSON

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


Search