DemandChanged

webhook

DemandChanged

Sent whenever a demand is created or updated. The payload reflects the full current state of the demand: the diligences already received and those still expected. Read demandType first to know which demand the payload describes: it is BankAccountOwnership for a proof of bank account ownership, and Income for a proof of income.

Payload

Current state of a demand

type

string

The type of the callback

demandType

string

enum

The type of the demand described by the payload. This is the discriminator to read before anything else. BankAccountOwnership is a proof that a bank account belongs to the business entity being onboarded, Income is a proof of income.

Allowed:

status

string

enum

The current status of the demand:

Initialized - the demand has been created and nothing has been received yet.
Pending - something has been received and its processing is in progress.
Incomplete - a diligence has been refused and the client can provide another one. Income demand only.
Complete - every expected diligence has been received and validated.
FraudSuspicion - a fraud is suspected on the demand. Income demand only.
Rejected - the demand has been rejected.

Allowed:

appUserId

string

The third party unique identifier

receivedDiligences

array of objects

Diligences already provided. Absent when the list is empty.

receivedDiligences

expectedDiligences

array of objects

Diligences still required (not yet validated). Absent when the list is empty.

expectedDiligences

Headers

Webhook-Id

string

required

UUID of the sent callback

Webhook-Processdate

date-time

required

Callback send date

Response

2XX

Webhook received and accepted for processing.
Your server should return this status code if the data was received successfully.