Pending Documents
An account can be opened with pending documents, as long as all mandatory registration data is sent. This is the limited (simplified) account, which has operational restrictions until the documents are regularized. This page explains how to track and resolve pending documents.
Pending document rules
The allowed operations are outflows only to accounts with the same ownership.
The BU must tell the end customer, at the time of the opening, that the account has an operational restriction and that the documents must be regularized. While there are pending documents, the BU must not present the account as Verified. The BU must also inform the deadline (28 days) and the consequences (block and then closing).
How to track
The documents webhook notifies the BU about the events and pending items of each document, as explained in Webhooks. The BU can also query the account to check its current condition, as explained in Account Status.
Pending flow
flowchart TD
A[Account opened with pending documents] --> B[Limited account: outflows only to the same ownership]
B --> C[Documents sent or resent]
C --> D{Documents validated?}
D -- Yes --> E[Documents validated and account condition updated]
D -- No --> C
Document status
The values of DocumentStatus are listed in the Code Mapping, in the section Document status.
How to regularize
- Receive the documents webhook, or identify the pending item by query.
- Identify which documents are pending and the status of each one.
- Send or resend the correct documents, as explained in Sending Documents. The requirements of each document are in Required Documents.
- Wait for the final result of the webhook and check the account condition.
If the account is blocked, see Blocking and Unlocking.
The diagram below shows how to regularize: the UpdatePersonDocument webhook carries the rejection reason (Reason) and message (Message), the BU guides the end customer and resends the documents, and a blocked account goes to Blocking and Unlocking.
flowchart TD
A["UpdatePersonDocument webhook with the document status"] --> B{"Was the document rejected?"}
B -->|Yes| C["The webhook carries the reason (Reason) and the message (Message)"]
C --> D["The BU guides the end customer and resends the correct documents"]
D --> A
B -->|No| E["The BU checks the status of each document and waits for the final result"]
E --> F{"Is the account blocked?"}
F -->|Yes| G["The BU follows Blocking and Unlocking"]
F -->|No| H["Documents validated and account condition checked"]
Updated 11 days ago

