Callback UserCreatedOrUpdated

Case: the verified nationality does not match the declared one.

In this example, the declared nationality is ES whereas the user provides a french ID card.

Sequence diagram

sequenceDiagram
autoNumber
Actor User
Participant Partner
Participant XPO
Participant KYC Provider
User ->> Partner: Account creation {"nationality": "ES"}
Partner ->> XPO: POST {{URLT}}/v2.0/users {"nationality": "ES"}
XPO ->> Partner: HTTP/200
XPO ->> Partner: Callback UserCreatedOrUpdated 
XPO -->> KYC Provider: Check ID
KYC Provider -->> XPO: ID validated but {"nationality": "FR"}
XPO ->> Partner: Callback UserCreatedOrUpdated {"nationality": "FR"}

Technical aspects

POST {{URLT}}/v2.0/users

 {
  "appUserId": "{{appuserid}}",
  "profile": {
    "civility": "Mrs",
    "firstName": "Corinne",
    "lastName": "Berthier",
    "birthName": "Berthier",
    "birthDate": "1965-12-06",
    "birthCity": "Paris",
    "birthZipCode": "75001",
    "birthCountry": "FR",
    "nationality": "ES",
    "phoneNumber": "+33675449988",
    "email": "{{firstname}}_{{lastname}}[email protected]",
    "address": {
      "street": "110 avenue de France",
      "supplementIn": "3e etage",
      "supplementOut": "Pilier D",
      "zipCode": "75013",
      "city": "Paris",
      "country": "FR",
      "area": ""
    }
  }

First Callback received : contains the information provided by the end user.

    "Payload": {
        "type": "UserCreatedOrUpdated",
        "appUserId": "de731dd3J",
        "recordStatus": "InProgress",
        "identificationLevel": "None",
        "onboardingDate": "2025-05-28 13:15:56",
        "profile": {
            "email": "[email protected]",
            "phoneNumber": "+33675449988",
            "firstName": "Corinne",
            "lastName": "Berthier",
            "birthName": "Berthier",
            "birthCity": "Paris",
            "birthZipCode": "75001",
            "birthCountry": "FR",
            "nationality": "ES",
            "birthDate": "1965-12-06",
            "civility": "Mrs",
            "address": {
					"street": "110 avenue de France",
      				"supplementIn": "3e etage",
  				    "supplementOut": "Pilier D",
      				"zipCode": "75013",
      				"city": "Paris",
      				"country": "FR",
      				"area": ""
            }
        },
        "dataCorrectionLogs": []
    }

Then a second Callback is received, after controls.

    "Payload": {
        "type": "UserCreatedOrUpdated",
        "appUserId": "de731dd3J",
        "recordStatus": "InProgress",
        "identificationLevel": "None",
        "onboardingDate": "2025-05-28 13:15:56",
        "profile": {
            "email": "[email protected]",
            "phoneNumber": "+33675449988",
            "firstName": "Corinne",
            "lastName": "Berthier",
            "birthName": "Berthier",
            "birthCity": "Paris",
            "birthZipCode": "75001",
            "birthCountry": "FR",
            "nationality": "FR",
            "birthDate": "1965-12-06",
            "civility": "Mrs",
            "address": {
					"street": "110 avenue de France",
      				"supplementIn": "3e etage",
  				    "supplementOut": "Pilier D",
      				"zipCode": "75013",
      				"city": "Paris",
      				"country": "FR",
      				"area": ""
            }
        },
        "dataCorrectionLogs": [
            {
                "propertyName": "profile.nationality",
                "originalValue": "ES",
                "newValue": "FR",
                "reason": "Correction"
            }
        ]
    }

Case: declared city contains an minor error

In this example, the declared birthCity is "Pariss" whereas the correct spelling is 'Paris'.

Sequence diagram

sequenceDiagram
autoNumber
Actor User
Participant Partner
Participant XPO
Participant KYC Provider
User ->> Partner: Account creation {"birthCity": "Pariss"}
Partner ->> XPO: POST {{URLT}}/v2.0/users {"birthCity": "Pariss"}
XPO ->> Partner: HTTP/200
XPO ->> Partner: Callback UserCreatedOrUpdated {"birthCity": "Paris"}

Technical aspects

POST {{URLT}}/v2.0/users

 {
  "appUserId": "{{appuserid}}",
  "profile": {
    "civility": "Mrs",
    "firstName": "Corinne",
    "lastName": "Berthier",
    "birthName": "Berthier",
    "birthDate": "1965-12-06",
    "birthCity": "Pariss",
    "birthZipCode": "75001",
    "birthCountry": "FR",
    "nationality": "FR",
    "phoneNumber": "+33675449988",
    "email": "{{firstname}}_{{lastname}}[email protected]",
    "address": {
      "street": "110 avenue de France",
      "supplementIn": "3e etage",
      "supplementOut": "Pilier D",
      "zipCode": "75013",
      "city": "Paris",
      "country": "FR",
      "area": ""
    }
  }

First Callback received : the user is created and the city was fixed

    "Payload": {
        "type": "UserCreatedOrUpdated",
        "appUserId": "de731dd3J",
        "recordStatus": "Initialized",
        "identificationLevel": "None",
        "onboardingDate": "2025-05-28 13:15:56",
        "profile": {
            "email": "[email protected]",
            "phoneNumber": "+33675449988",
            "firstName": "Corinne",
            "lastName": "Berthier",
            "birthName": "Berthier",
            "birthCity": "Paris",
            "birthZipCode": "75001",
            "birthCountry": "FR",
            "nationality": "ES",
            "birthDate": "1965-12-06",
            "civility": "Mrs",
            "address": {
					"street": "110 avenue de France",
      				"supplementIn": "3e etage",
  				    "supplementOut": "Pilier D",
      				"zipCode": "75013",
      				"city": "Paris",
      				"country": "FR",
      				"area": ""
            }
        },
        "dataCorrectionLogs": [
            {
                "propertyName": "profile.birthCity",
                "originalValue": "Pariss",
                "newValue": "Paris",
                "reason": "Normalization"
            }
        ]
    }

Case: data correction

In this case, the enduser changes the firstName.
This case occurs during the onboarding, or during the relationship, and with or without Strong Authentication according to the use case.

PUT {{URLT}}/v2.0/users/{appUserId}

{
  "profile": {
    "firstName": "Colinne"
  }
}

The callback contains the new value.

  "Payload": {
        "type": "UserCreatedOrUpdated",
        "appUserId": "12526b6dJ",
        "recordStatus": "Initialized",
        "identificationLevel": "None",
        "onboardingDate": "2025-05-28 14:37:42",
        "profile": {
            "email": "[email protected]",
            "phoneNumber": "+33675449988",
            "firstName": "Colinne",
            "lastName": "Berthier",
            "birthName": "Berthier",
            "birthCity": "Paris",
            "birthZipCode": "75001",
            "birthCountry": "FR",
            "nationality": "FR",
            "birthDate": "1965-12-06",
            "civility": "Mrs",
            "address": {
					"street": "110 avenue de France",
      				"supplementIn": "3e etage",
  				    "supplementOut": "Pilier D",
      				"zipCode": "75013",
      				"city": "Paris",
      				"country": "FR",
      				"area": ""
            }
        },
        "dataCorrectionLogs": []
    }