Skip to main content

Proof of Source of Funds (PoSoF)

Proof of Source of Funds (PoSoF) entitlements allow users to increase their deposit limits by providing verifiable documentation regarding the origin of their funds.

By default, all onboarded accounts have a basic deposit limit (Level 1). To upgrade to higher tiers, users must undergo a PoSoF verification process involving manual compliance review.

Entitlement Summary​

FieldValueDescription
Nameposof_level_2, posof_level_3The system names used to trigger the upgrade workflows.
Applies ToPersonPoSoF upgrades are currently applicable to individual accounts.
Prerequisites1. Onboarded: The entity must have completed the basic KYC onboarding.
OutcomeThe account's PoSoF tier is updated. The final tier is decided by compliance and returned in the completion webhook.

PoSoF Tiers​

LevelDescriptionVerification Type
Level 1Basic tier granted upon successful onboarding.Automated
Level 2Increased deposit limits.Manual Review
Level 3Maximum deposit limits.Manual Review

High-Level Workflow​

The PoSoF process follows the standard Entitlement Trigger Flow. Unlike the automated Level 1 checks, higher tiers involve a manual review by the compliance team.

  1. Trigger: Initiate the upgrade request via POST /persons/{id}/entitlement_triggers using the desired level's name (posof_level_2 or posof_level_3).
  2. Initial Requirements: The system issues a requirementsQuestionnaire webhook (Reason: posof_level_upgrade). The user must provide information about their wealth and upload supporting documents.
  3. Manual Review & Additional Information Loop: A compliance officer reviews the submission.
    • Iterative Requests: If the documents are unclear or more detail is needed, the officer can trigger a new requirements loop.
    • Notification: Your application will receive a new requirementsQuestionnaire webhook (Reason: posof_level_upgrade).
  4. Final Decision: The compliance officer makes the final determination on the account's tier.
  5. Completion: The workflow concludes with an entitlementCompleted webhook.

Upgrade Rules​

Direct Upgrades​

Users are not required to follow a linear progression (Level 1 → Level 2 → Level 3). A user currently at Level 1 can trigger Level 3 directly if they have the necessary documentation to support the higher limit.

Compliance Decision & Agent Discretion​

When a user triggers an upgrade (e.g., Level 3), the compliance team evaluates all provided documents. The compliance officer has the final say on the granted level. Even if a user requests Level 3, the officer may determine that only Level 2 is appropriate based on the documentation.

The actual level granted is communicated via the entitlementCompleted webhook payload:

{
  "notification_type": "entitlementCompleted",
  "details": {
    "posof_level": "Level 2"
  }
}

Workflow Diagram​