Capital deposit statuses

A capital deposit tracks three interlocking state machines: the case, each shareholder, and each document. They advance together, and the case status reflects where the whole deposit stands.

The three status machines

The case is the master clock for the whole deposit: it can't pass a step until the shareholders and documents it depends on are ready.

Case statuses

The CapitalDepositCase status paces the whole deposit. It moves from initial requirements through Swan's review and the notary steps to Completed, or to Canceled at any point.

Case status	Explanation
WaitingForInitialRequirements	The case has been initiated and is waiting for shareholder verification, fund transfers, document uploads, and completion of company onboarding. Next steps: When all initial requirements are met, the status moves to PendingInternalReview.
PendingInternalReview	Swan is reviewing the information and documents provided. Next steps: If Swan needs more details or corrections, the status moves to WaitingForAdditionalInformation. If the review passes, the status moves to WaitingForNotaryShareDepositCertificate.
WaitingForAdditionalInformation	After review, Swan has requested additional details or corrections from the customer and is awaiting their response. Next steps: When the customer responds, the status returns to PendingInternalReview.
WaitingForNotaryShareDepositCertificate	Notary reviews the deposited funds and submitted documents, then creates the certificate and uploads it to Swan. Next steps: When the certificate is uploaded, the status moves to WaitingForRegisterExtract.
WaitingForRegisterExtract	The end user uploads their register extract for notary review. Next steps: When the register extract is uploaded, the status moves to WaitingForNotaryTransfer.
WaitingForNotaryTransfer	Notary reviews the register extract. Next steps: If the notary approves, the status moves to Completed. If the document is rejected by either Swan or the notary, the case moves back to WaitingForRegisterExtract.
Canceled	The case was canceled before completion by either you or Swan. A cancelation reason code is available in the CapitalDepositCaseCanceledStatusInfo type.
Completed	Notary reviewed and approved all elements and transferred the funds to the new company; the process is complete.

Shareholder statuses

Each shareholder carries their own status reflecting how far they've onboarded and transferred funds: from PendingOnboarding, through verification and transfer, to CapitalFundsWiredToNotary. The case only completes once every shareholder reaches that final state.

Shareholder status	Explanation
PendingOnboarding	Default status after the shareholder is created; the shareholder must complete their onboarding and their account must be created to continue. Next steps: When the account is created, the status moves to WaitingForVerification, or directly to WaitingForTransfer if the account holder is already Verified.
WaitingForVerification	Possible status if the account holder verification isn't complete at the moment the shareholder's account is created. Status bypassed if the account holder status is already Verified. Next steps: When verification completes, the status moves to WaitingForTransfer.
WaitingForTransfer	Waiting for the shareholder to deposit the full share capital in their Swan account created during onboarding, which must be transferred from an account belonging to the shareholder. The transfer must be a SEPA Credit Transfer; international credit transfers aren't accepted and are rejected automatically. Next steps: When the full share capital arrives, the status moves to CapitalTransferred.
CapitalTransferred	Waiting for the rest of the capital deposit case to be ready and the funds to be transferred to the notary. Next steps: When Swan wires the funds to the notary, the status moves to CapitalFundsWiredToNotary.
CapitalFundsWiredToNotary	Still waiting for the rest of the capital deposit case to be ready, but now the funds are with the notary.
CapitalDepositCanceled	When a CapitalDepositCase is Canceled, the shareholder status changes to CapitalDepositCanceled. If an account was already created for the shareholder, the account is also closed automatically.

Document statuses

Each required document moves from Pending to Uploaded, then to Validated or Refused. A Refused document must be re-uploaded before the case can move forward.

Document status	Explanation
Pending	Place for the document is created, but the document isn't uploaded yet.
Uploaded	Document successfully uploaded; you can change and re-upload the document as long as it retains the status Uploaded. Next steps: Swan reviews the document and either validates or refuses it.
Validated	Swan validated the document.
Refused	Document doesn't meet requirements. Review reasonCode for a refusal category and the optional reason for a plain-text explanation. Both are visible on your Dashboard and available through the API. Next steps: Upload a new document, then the status returns to Uploaded.

How statuses cascade

The three models aren't independent. Beyond the forward gating between the case, shareholders, and documents, the dependency also runs in reverse: canceling the case flips every shareholder to CapitalDepositCanceled and closes any account already opened for a shareholder.