GetUltimateBeneficialOwner: Get all Ultimate Beneficial Owners Associated with a Payment Account

How it works

By calling this method, you will get all the Ultimate Beneficial Owners associated with a legal payment account.

Request


XML

<GetUltimateBeneficialOwner xmlns="Service_mb">
   <wlLogin>string</wlLogin>
   <wlPass>string</wlPass>
   <wallet>string</wallet>
   <language>string</language>
   <version>string</version>
   <walletIp>string</walletIp>
   <walletUa>string</walletUa>
</GetUltimateBeneficialOwner>

JSON

{
  "p": {
    "wlLogin": "string",
    "wlPass": "string",
    "wallet": "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

ultimateBeneficialOwnerIdUltimate Beneficial Owner Id

Yes

[1 :100] char54589812458

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

isActive

Indicate if the Ultimate Beneficial Owner is active or not

0: no (default)
1: yes

No[1] char0

Response


XML

<GetUltimateBeneficialOwnerResponse xmlns="Service_mb">
      <GetUltimateBeneficialOwnerResult>
        <ULTIMATEBENEFICIALOWNER>
          <id>long</id>
          <firstName>string</firstName>
          <lastName>string</lastName>
          <nationality>string</nationality>
          <dateOfBirth>string</dateOfBirth>
          <cityOfBirth>string</cityOfBirth>
          <countryOfBirth>string</countryOfBirth>
          <countryOfResidence>string</countryOfResidence>
          <startDate>string</startDate>
          <endDate>string</endDate>
        </ULTIMATEBENEFICIALOWNER>
        <ULTIMATEBENEFICIALOWNER>
          <id>long</id>
          <firstName>string</firstName>
          <lastName>string</lastName>
          <nationality>string</nationality>
          <dateOfBirth>string</dateOfBirth>
          <cityOfBirth>string</cityOfBirth>
          <countryOfBirth>string</countryOfBirth>
          <countryOfResidence>string</countryOfResidence>
          <startDate>string</startDate>
          <endDate>string</endDate>
        </ULTIMATEBENEFICIALOWNER>
      </GetUltimateBeneficialOwnerResult>
    </GetUltimateBeneficialOwnerResponse>

JSON

{
  "GetUltimateBeneficialOwnerResponse": {
    "-xmlns": "Service_mb_json",
    "GetUltimateBeneficialOwnerResult": {
      "ULTIMATEBENEFICIALOWNER": [
        {
          "id": "long",
          "firstName": "string",
          "lastName": "string",
          "nationality": "string",
          "dateOfBirth": "string",
          "cityOfBirth": "string",
          "countryOfBirth": "string",
          "countryOfResidence": "string",
          "startDate": "string",
          "endDate": "string"
        },
        {
          "id": "long",
          "firstName": "string",
          "lastName": "string",
          "nationality": "string",
          "dateOfBirth": "string",
          "cityOfBirth": "string",
          "countryOfBirth": "string",
          "countryOfResidence": "string",
          "startDate": "string",
          "endDate": "string"
        }
      ]
    }
  }
}

Search