Appearance

Emulation ​

Emulation features are only available in Sandbox environment.

Simulate user validation ​

Some actions, like creating specific types of Wallets, require the user to be in a VALIDATED status.

In Sandbox, you can validate the user for testing purposes by adding the .userStatusValidated suffix to the User's lastname.

You can do so with the following requests:

Bulb icon

Tip – Compatible with KYC emulation

You can cumulate the suffixes to achieve both status and KYC emulation at once. For instance: lastname.refused.userStatusValidated.

Example ​

Let's update a User's lastname to set the status to VALIDATED.

bash
curl -X PUT '{baseUrl}/v1/users' \
	--header 'Authorization: Bearer {accessToken}' \
	--header 'Content-Type: application/json' \
	-d '{payload}'

With a {payload} containing the suffixed lastname:

json
{
    "lastname": "Oak.userStatusValidated"
}

Returns the updated user with the new userStatus:

json
{
    "users": [
        {
            "userId": 101391362,
            "userTypeId": 1,
            "userStatus": "VALIDATED",
            "userTag": "",
            "parentUserId": 0,
            "parentType": "",
            "controllingPersonType": 0,
            "employeeType": 0,
            "specifiedUSPerson": 0,
            "title": "M",
            "firstname": "Alex",
            "lastname": "Oak.userStatusValidated",
            "middleNames": "",
            "birthday": "1982-05-30",
            "email": "Waino.Cole@gmail.com",
            "address1": "8214 Kris Turnpike",
            "address2": "",
            "postcode": "75017",
            "city": "Paris",
            "state": "",
            "country": "FR",
            "countryName": "France",
            "phone": "+33141358530",
            "mobile": "",
            "nationality": "FR",
            "nationalityOther": "",
            "placeOfBirth": "Paris",
            "birthCountry": "FR",
            "occupation": "",
            "incomeRange": "0-18",
            "legalName": "",
            "legalNameEmbossed": "",
            "legalRegistrationNumber": "",
            "legalTvaNumber": "",
            "legalRegistrationDate": "0000-00-00",
            "legalForm": "",
            "legalShareCapital": 0,
            "entityType": 0,
            "legalSector": "",
            "legalAnnualTurnOver": "",
            "legalNetIncomeRange": "",
            "legalNumberOfEmployeeRange": "",
            "effectiveBeneficiary": 0,
            "kycLevel": 2,
            "kycReview": 0,
            "kycReviewComment": "",
            "isFreezed": 0,
            "isFrozen": null,
            "language": "",
            "optInMailing": null,
            "sepaCreditorIdentifier": "",
            "taxNumber": "",
            "taxResidence": "",
            "position": "",
            "personalAssets": "",
            "createdDate": "2025-01-17 09:39:21",
            "modifiedDate": "2025-01-17 10:39:45",
            "walletCount": 0,
            "payinCount": 0,
            "totalRows": "1",
            "activityOutsideEu": null,
            "economicSanctions": null,
            "residentCountriesSanctions": null,
            "involvedSanctions": null,
            "address3": null,
            "timezone": null,
            "occupationType": "",
            "isOnStockExchange": 0,
            "secondaryAddress1": "",
            "secondaryAddress2": "",
            "secondaryAddress3": "",
            "secondaryPostcode": "",
            "secondaryCity": "",
            "secondaryState": "",
            "secondaryCountry": "",
            "clientId": "929252",
            "sanctionsQuestionnaireDate": null,
            "codeStatus": "110009",
            "informationStatus": "",
            "legalSectorType": "",
            "sourceOfFunds": "",
            "distributionCountry": null,
            "entitySanctionsQuestionnaire": 0,
            "monthlyIncomeRange": null,
            "personalAssetsRange": null,
            "occupationCategory": null,
            "birthCityCode": null
        }
    ]
}