Capital deposit reference

Cancelation reason codes, document refusal reasons, and required documents for capital deposit cases.

For the case, shareholder, and document state machines, see capital deposit statuses.

Cancelation reason codes

When a capital deposit case has the status Canceled, a reason code is available on the CapitalDepositCaseCanceledStatusInfo type.

Retroactive migration

Capital deposit cases canceled before 2 April 2026 were migrated retroactively to the current cancelation reason codes in June 2026, so every canceled case carries a reason code.

Reason code	Explanation
KYCIssue	Documents missing, incorrect, or no reply.
ForbiddenActivity	Prohibited business sectors.
DuplicateOnboarding	A second account was created by mistake.
DeniedCountryResidency	High-risk UBO or resident.
RefusedIbanCountry	The account holder was assigned the wrong IBAN country, or the IBAN country isn't allowed.
CompanyRegistrationCountryNotSupported	Swan doesn't support the company registration country.
BusinessInactiveOrNotRegistered	The company is inactive or not registered.
UnsupportedLegalForm	Swan can't onboard the legal form.
TCViolation	Terms and Conditions violation.
CapitalDepositWithdrawn	The capital deposit has been withdrawn.
CapitalDepositRefusedByNotary	The notary refused the capital deposit case.
ComplianceReason	Cancelation for compliance reasons.
RegulatoryRequirement	Cancelation required by regulation.

These reason codes come from the dedicated CapitalDepositCaseCancellationReasonType enum. Most values are shared with account closure reason codes, which apply at the account level. When a capital deposit completes successfully, the case isn't canceled; instead, shareholder accounts are closed with the account-level reason code CapitalDepositCompleted.

Document refusal reasons

When a capital deposit document is Refused, a reason code is available on the CapitalDepositDocumentRefusedStatusInfo type, with an optional plain-text reason adding details.

These reason codes come from the dedicated DocumentReasonCode enum. Supporting documents use a different enum for refusal reasons.

Reason code	Explanation
CompanyNameMismatch	The company name in the document submitted doesn't match Swan's records.
DeclaredAmountMismatch	The declared amount in the document submitted doesn't match Swan's records.
ExpiredDocument	Documents must have been issued within the last three months.
InvalidAddress	The address in the document submitted doesn't match Swan's records.
InvalidDocument	The document submitted isn't valid or in an accepted format.
InvalidOrMissingData	The name in the document submitted is invalid, missing, or not clearly visible.
MissingAccommodationProviderId	An identity document for the accommodation provider is required.
MissingAccommodationProviderIdLetter	The accommodation provider's ID and letter providing proof of accommodation are required.
MissingAccommodationProviderLetter	A letter providing proof of accommodation from the provider is required.
UnacceptableDocument	The document submitted doesn't match the requested document type.
ProviderColorIdDocumentRequired	The document must be submitted in color.
MissingSignature	The document submitted must be signed or dated.
BadDocumentQuality	The quality of the document submitted is too low. All document content must be clear and legible.
FullDocumentRequired	The entire document must be submitted, not just a portion of the document.
MissingProviderProofOfAddress	The accommodation provider's proof of address is required.
MissingProviderProofOfAddressAndIdDocument	The accommodation provider's ID and proof of address are required.
PowerOfAttorneyToSwanRequired	A signed and dated Power of Attorney must be provided to Swan.
MissingCompanyDomiciliationStatement	A document stating the company's registered address is required. This document can be referred to as a "domiciliation statement".
HandwrittenOrCertifiedElectronicSignatureRequired	The signature must be handwritten or electronically certified.
ComplianceReason	The document was refused for compliance reasons.
InvalidDepositBankName	The bank name in the articles of association document is invalid.
MissingCompanyProviderRegisterExtract	The register extract of the company providing the accommodation and an identity document for its legal representative are required.

List of required documents

All documents are mandatory. The lease agreement marked with an asterisk (∗) has alternatives; refer to the specifications for Future company > lease agreement.

Stakeholder	Document	API document type
Individual shareholders	Proof of address	ProofOfIndividualAddress Refer to proof of address for acceptable documents.
	Identity document proving the shareholder's identity (collected during identification)	ProofOfIdentity
Company shareholders	Proof of registration of the company	RegisterExtract Refer to proof of registration for acceptable documents.
	Identity document proving the identity of the company shareholder's legal representative (collected during identification if they are an account member).	ProofOfIdentity
Future company	Document available only after the notary validates the case, uploaded at a specific time during the capital deposit process	RegisterExtract
	Draft of the articles of incorporation	ArticlesOfIncorporation
	Lease agreement for official company address ∗	CompanyLeaseAgreement
	Lease mandate from legal representative	PowerOfAttorney Template available in French

Specifications for Future company > lease agreement ∗

If a future company doesn't have a company lease agreement as proof of the official company address, other elements are required according to their situation. All identity documents must be in full color and include the front and back of the document.

Official company address is...	Elements required
Legal representative's address	Business address affidavit ("domiciliation statement") from the legal representative If the legal representative isn't a shareholder: Identity document for the legal representative Proof of address for the legal representative
Legal representative's address, but they're renting or hosted by someone else	Business address affidavit ("domiciliation statement") from the host If the legal representative isn't a shareholder: Identity document for the legal representative Identity document for the host Proof of address for the host
Another company's office address	KBIS of host company issued within the last three months Business address affidavit ("domiciliation statement") from the host company's legal representative Identity document for the legal representative who provided the business address affidavit