Example - Legal Person

Your customer is a Legal Person, which is a company entity, please fill-in the natural person fields, refer to the following payload.

Legal Person that allows the originator is a natural person and the beneficiary is a legal person, vice versa. It is simply the same concept that swapping fields between Originator.originatorPersons and Beneficiary.beneficiaryPersons.

If a person is a legal person, that person's field should have both naturalPerson: CEO name and legalPerson: Company name.

For example, the originator is natural person, and beneficiary is legal person, the following is valid:

• Originator.originatorPersons[].naturalPerson ✅
• Beneficiary.beneficiaryPersons[].naturalPerson (CEO name) ✅
• Beneficiary.beneficiaryPersons[].legalPerson (Company name) ✅

*If you don’t have the info, please leave it blank string ("") to the field rather than omit the field in the struct.

The above’s example struct is following:

{
  "ivms101": {
    "Originator": {
      "accountNumber": ["[Please Fill in Account Number]"],
      "originatorPersons": [
        {
          "naturalPerson": {
            "countryOfResidence": "[2-Alpha Country Code]",
            // optional
            "geographicAddress": [
              {
                "country": "[2-Alpha Country Code]",
                "townName": "",
                "addressType": "[One of: HOME,BIZZ,GEOG]",
                "addressLine": [""]
              }
            ],
            "name": {
              // required
              "nameIdentifier": [
                {
                  "nameIdentifierType": "LEGL",
                  "primaryIdentifier": "[LastName or LastName+FirstName]",
                  "secondaryIdentifier": "[FirstName or Blank]"
                }
              ],
              // required
              "localNameIdentifier": [
                {
                  "nameIdentifierType": "LEGL",
                  "primaryIdentifier": "[LastName or LastName+FirstName]",
                  "secondaryIdentifier": "[FirstName or Blank]"
                }
              ],
              // optional
              "phoneticNameIdentifier": [
                {
                  "nameIdentifierType": "LEGL",
                  "primaryIdentifier": "[LastName or LastName+FirstName]",
                  "secondaryIdentifier": "[FirstName or Blank]"
                }
              ]
            },
            // optional
            "nationalIdentification": {
              "countryOfIssue": "[2-Alpha Country Code]",
              "nationalIdentifier": "[ID CODE/Number]",
              "nationalIdentifierType": "LEGL",
              "registrationAuthority": "[The name who (Government,Department,Company...etc) authorized this identity number]"
            }
          }
        }
      ]
    },
    // Your company info (Because you're an originating VASP)
    "OriginatingVASP": {
      "originatingVASP": {
        // required, you are an legal person
        "legalPerson": {
          "countryOfRegistration": "[2-Alpha Country Code]",
          // required
          "geographicAddress": [
            {
              "country": "[2-Alpha Country Code]",
              "townName": "[Town Name]",
              "addressType": "GEOG",
              "addressLine": ["[Full Address]"]
            }
          ],
          "name": {
            "nameIdentifier": [
              {
                // required
                "legalPersonName": "[Your Company Name]",
                "legalPersonNameIdentifierType": "LEGL"
              }
            ]
          },
          "nationalIdentification": {
            "countryOfIssue": "[2-Alpha Country Code]",
            "nationalIdentifier": "[ID Code]",
            "nationalIdentifierType": "LEGL",
            "registrationAuthority": "[The name who (Government,Department,Company...etc) authorized this identity number]"
          }
        }
      }
    },
    "Beneficiary": {
      "accountNumber": ["[Please Fill in Account Number]"],
      "beneficiaryPersons": [
        {
          "legalPerson": {
            "name": {
              "nameIdentifier": [
                {
                  "legalPersonName": "[COMPANY Name]",
                  "legalPersonNameIdentifierType": "LEGL"
                }
              ]
            }
          }
        },
        {
          "naturalPerson": {
            "countryOfResidence": "[2-Alpha Country Code]",
            // optional
            "geographicAddress": [
              {
                "country": "[2-Alpha Country Code]",
                "townName": "",
                "addressType": "[One of: HOME,BIZZ,GEOG]",
                "addressLine": [""]
              }
            ],
            "name": {
              // required
              "nameIdentifier": [
                {
                  "nameIdentifierType": "LEGL",
                  "primaryIdentifier": "[LastName or LastName+FirstName]",
                  "secondaryIdentifier": "[FirstName or Blank]"
                }
              ],
              // required
              "localNameIdentifier": [
                {
                  "nameIdentifierType": "LEGL",
                  "primaryIdentifier": "[LastName or LastName+FirstName]",
                  "secondaryIdentifier": "[FirstName or Blank]"
                }
              ],
              // optional
              "phoneticNameIdentifier": [
                {
                  "nameIdentifierType": "LEGL",
                  "primaryIdentifier": "[LastName or LastName+FirstName]",
                  "secondaryIdentifier": "[FirstName or Blank]"
                }
              ]
            },
            // optional
            "nationalIdentification": {
              "countryOfIssue": "[2-Alpha Country Code]",
              "nationalIdentifier": "[ID CODE/Number]",
              "nationalIdentifierType": "LEGL",
              "registrationAuthority": "[The name who (Government,Department,Company...etc) authorized this identity number]"
            }
          }
        }
      ]
    }
  }
}