Corporate update

Consumer can be updated either by a Partner, or directly by the Enduser himself.

Information update

PATCH Consumer endpoint should be used to change different Consumer informations : external Id, email address, phone number, address, source of funds, other source of funds, occupation, other occupation, last terms accepted.

info

After updating the email address or the phone number if it was previously "VERIFIED", the new one will have to be verified again, using the dedicated endpoint.

Last Terms and Conditions accepted

One important Update the have in mind is the "lastTermsAccepted" field :

One important Update the have in mind is the "lastTermsAccepted" field :

Indeed, if a new version of the Terms and Conditions is released, Consumer has to accept these before using banking features again.

Please refer to the Terms & Conditions Guide page for more information

Here is the Request Body of the Consumer Udpate endpoint :

Name	Type	Description
externalId	string [0 .. 511] characters	A unique identifier that you can use to link this consumer to a user in your system.
address	object (AddressRequestDto)	The address of the consumer.
emailAddress	string	The consumer's email address.
sourceOfFunds	string	The source of funds for the consumer. Enum: COMPENSATION_PAYOUT, COMPANY_PROFITS, COMPANY_SALE, DIVIDEND_PAYMENTS, DIVORCE_SETTLEMENT, FIXED_DEPOSITS, GIFT, INHERITANCE, INSURANCE_PAYOUT, LOAN, LOTTERY_OR_GAMBLING_WIN, RETIREMENT_INCOME, SALE_OF_INVESTMENT, SALE_OF_PROPERTY, SAVINGS_FROM_SALARY, OTHER.
otherSourceOfFunds	string [0 .. 511] characters	Description of source of funds if OTHER is selected.
occupation	string	The consumer's usual or principal work or business as a means of earning a living. Enum: BUSINESS_OWNER, CLERGY, CRAFTSMAN, ENGINEER, EXECUTIVE, FARMER, FREELANCE, LIBERAL_PROFESSION, POLITICIAN, PROFESSOR, PUBLIC_SERVANT, RETIRED, SHOPKEEPER, STUDENT, UNEMPLOYED, WORKER, OTHER.
otherOccupation	string [0 .. 511] characters	Description of occupation if OTHER is selected.
lastTermsAccepted	string	The version of the terms and conditions signed by the consumer.
metadata	object (Metadata)	A custom field to save data, limited to 3000 characters.

{
  "externalId": "string",
  "address": {
    "isoCountryCode": "BEL",
    "city": "string",
    "postalCode": "string",
    "street": "string",
    "number": "string",
    "refinement": "string",
    "stateOrProvince": "string"
  },
  "emailAddress": "string",
  "sourceOfFunds": "COMPENSATION_PAYOUT",
  "otherSourceOfFunds": "string",
  "occupation": "BUSINESS_OWNER",
  "otherOccupation": "string",
  "lastTermsAccepted": "1.0",
  "metadata": {
    "property1": { },
    "property2": { }
  }
}

Other information

If you want to change information for example as usage name, please contact your customer care.

danger

If you want to change Enduser personal information for example your last name, you will have to perform another KYC under conditions.

Suspend a Corporate

A corporate can be suspended, using the "Suspend an end-user" endpoint.

This can be done for different reason (fraud and security, unpayed subscription, ...).

Once suspended, operations related to this enduser won't be allowed, no Outgoing transaction can be done from this Corporate : transaction to a beneficiary will be Declined and Cards will be blocked.

Corporate suspension status will be set to SUSPENDED

warning

This does not prevent Incoming transactions. Money can still be received with Incoming transfers for example.

This is a reversible state, and a enuser can be unsuspended with the "Unsuspend a enduser" endpoint.