Document Status Change

Use webhook notifications to monitor changes to KYC document statuses.

Two notification categories can be relevant when handling document status changes:

Document status change

When the status of a document changes, Lemonway sends a webhook notification with NotifCategory = 9.

Notification payload

Example

{
  "NotifCategory": "9",
  "NotifDate": "2015-11-01T16:44:55.883",
  "IntId": "32",
  "ExtId": "jkdc",
  "Status": "6",
  "DocType": "0",
  "DocId": "4646"
}

Document rejection details

For documents rejected during Online Onboarding, detailed rejection information is provided through the Online Onboarding: Profile status notification (NotifCategory = 49).

When applicable, the notification includes a Rejections array identifying the rejected document and the reason for rejection.

The Rejections array belongs to the Online Onboarding Profile status notification (NotifCategory = 49) and is separate from the Document status changed notification (NotifCategory = 9).

Rejections object

Example rejection

{
  "Rejections": [
    {
      "Type": "Document",
      "ID": "...",
      "Reason": "4"
    }
  ]
}

In this example, Reason = "4" indicates that the document was rejected because it belongs to the wrong individual.

Rejection reason codes