Create your capital deposit case

Use the createCapitalDepositCase mutation to create your capital deposit case.

Multi-step process

This page explains step 1 of a multi-step process. Refer to the France guide for the whole process.

Guide

1. Call the createCapitalDepositCase mutation.
   • By default, objects are added to the API Explorer in the following order:
     1. companyName
     2. companyShareholders
     3. individualShareholders
     4. totalCapitalDepositAmount
     5. onboardingCapitalDepositCompany
2. companyName: Enter the name of the future company (line 4).
3. companyShareholders: Add required information about company shareholders (starts on line 5).
   1. Add the onboardingInfo object to prefill onboarding information for individualUltimateBeneficialOwners (starts on line 8).
   2. You can also prefill information about the company (starts on line 33).
4. individualShareholders: Add required information about individual shareholders (starts on line 50).
5. totalCapitalDepositAmount: Add the combined capital deposit amount from all company and individual shareholders (line 69).
6. onboardingCapitalDepositCompany: Add the company onboarding object to start creating the future company account (starts on line 70).
   • Note that individualUltimateBeneficialOwners and company information should match the information entered in step 3.
7. Add the CreateCapitalDepositCaseSuccessPayload (starts on line 107). Consider adding several pieces of important information, such as:
   1. companyOnboarding > id.
   2. documents > type, status, and id.
   3. shareholders information, including onboarding > id.
8. Add rejections in case the mutation doesn't succeed (starts on line 154).

Mutation

🔎 Open the mutation in API Explorer

mutation createCase {
  createCapitalDepositCase(
    input: {
      companyName: "MyBrand"
      companyShareholders: {
        capitalDepositAmount: { value: "10000", currency: "EUR" }
        name: "Company shareholder"
        onboardingInfo: {
          individualUltimateBeneficialOwners: [
            {
              type: LegalRepresentative
              birthCity: "Paris"
              birthCityPostalCode: "75000"
              birthCountryCode: "FRA"
              birthDate: "02/02/1988"
              direct: false
              firstName: "Jules"
              lastName: "Fleury"
              totalCapitalPercentage: 51
            }
            {
              type: HasCapital
              birthCity: "Paris"
              birthCityPostalCode: "75000"
              birthCountryCode: "FRA"
              birthDate: "09/01/1989"
              direct: false
              firstName: "Malika"
              lastName: "Ngoma"
              totalCapitalPercentage: 26
            }
          ]
          accountName: "MyBrand company account"
          businessActivity: Arts
          businessActivityDescription: "Description required"
          companyType: Company
          email: "bonjour@mybrand.fr"
          isRegistered: false
          language: "fr"
          monthlyPaymentVolume: Between50000And100000
          name: "Company shareholder"
          residencyAddress: {
            addressLine1: "123 avenue de Paris"
            city: "Paris"
            country: "FRA"
            postalCode: "75000"
          }
        }
      }
      individualShareholders: {
        firstName: "Henri"
        lastName: "Dupont"
        birthDate: "01/11/1992"
        nationality: "FRA"
        capitalDepositAmount: { value: "500", currency: "EUR" }
        onboardingInfo: {
          email: "henri.dupont@mybrand.fr"
          language: "fr"
          employmentStatus: Employee
          monthlyIncome: Between1500And3000
          residencyAddress: {
            addressLine1: "1 rue de la Paix"
            city: "Paris"
            country: "FRA"
            postalCode: "75000"
          }
        }
      }
      totalCapitalDepositAmount: { value: "10500", currency: "EUR" }
      onboardingCapitalDepositCompany: {
        individualUltimateBeneficialOwners: [
          {
            type: LegalRepresentative
            birthCity: "Paris"
            birthCityPostalCode: "75000"
            birthCountryCode: "FRA"
            birthDate: "02/02/1988"
            direct: false
            firstName: "Jules"
            lastName: "Fleury"
            totalCapitalPercentage: 51
          }
          {
            type: HasCapital
            birthCity: "Paris"
            birthCityPostalCode: "75000"
            birthCountryCode: "FRA"
            birthDate: "09/01/1989"
            direct: false
            firstName: "Malika"
            lastName: "Ngoma"
            totalCapitalPercentage: 26
          }
        ]
        accountName: "MyBrand company account"
        accountCountry: FRA
        businessActivity: Arts
        businessActivityDescription: "Description required"
        companyType: Company
        email: "bonjour@mybrand.fr"
        isRegistered: false
        language: "fr"
        monthlyPaymentVolume: Between10000And50000
      }
    }
  ) {
    ... on CreateCapitalDepositCaseSuccessPayload {
      capitalDepositCase {
        companyName
        id
        companyOnboarding {
          id
          createdAt
          info {
            type
          }
        }
        documents {
          type
          status
          id
        }
        shareholders {
          info {
            ... on IndividualShareholder {
              __typename
              firstName
              lastName
            }
            ... on CompanyShareholder {
              __typename
              name
            }
          }
          status
          id
          onboarding {
            id
          }
          documents {
            type
            status
            id
          }
        }
        status
        totalCapitalDepositAmount {
          currency
          value
        }
        updatedAt
      }
    }
    ... on ForbiddenRejection {
      __typename
      message
    }
    ... on BadRequestRejection {
      __typename
      message
    }
    ... on InternalErrorRejection {
      __typename
      message
    }
  }
}

Payload

The options selected in the mutation example produce the following success payload. Note several pieces of key information:

1. Your capital deposit case id (line 6).
2. Your company onboarding id (line 8).
3. Information about required documents, including the type, status, and id (starts on line 14).
4. Information about all shareholders (starts on line 41), including:
   • Onboarding id (example line 51)
   • Document id (example line 57)
5. Status of the entire capital deposit case (line 100).

Queries

This information will help you complete your capital deposit.

If needed, use the capitalDepositCase query to get information about an individual case, or the capitalDepositCases query for information about all ongoing capital deposit cases.

{
  "data": {
    "createCapitalDepositCase": {
      "capitalDepositCase": {
        "companyName": "MyBrand",
        "id": "4ca1be36-1760-4966-8303-6f1fcaa3fc6c",
        "companyOnboarding": {
          "id": "e29fcd1b-8a94-48d5-93fb-fb58ed667a60",
          "createdAt": "2023-11-02T10:15:42.093Z",
          "info": {
            "type": "Company"
          }
        },
        "documents": [
          {
            "type": "ArticlesOfIncorporation",
            "status": "Pending",
            "id": "9390583f-f63d-43eb-b1ad-95aa786a76f4"
          },
          {
            "type": "CompanyLeaseAgreement",
            "status": "Pending",
            "id": "97c71862-48d2-4f77-b3f7-3f1461cb8bb2"
          },
          {
            "type": "PowerOfAttorney",
            "status": "Pending",
            "id": "d75b910b-21c2-45d6-ade6-2fc9af00a0a2"
          },
          {
            "type": "CapitalShareDepositCertificate",
            "status": "Pending",
            "id": "3e7c08dd-7d3e-484a-ab93-416bd5337fde"
          },
          {
            "type": "RegisterExtract",
            "status": "Pending",
            "id": "f8be85b9-23b6-4722-a179-c23bf3c28842"
          }
        ],
        "shareholders": [
          {
            "info": {
              "__typename": "IndividualShareholder",
              "firstName": "Henri",
              "lastName": "Dupont"
            },
            "status": "PendingOnboarding",
            "id": "ba874dca-0c09-482b-beba-ceea3e3fa39d",
            "onboarding": {
              "id": "0a5349ba-709d-4e6e-84eb-be19eca2cd0b"
            },
            "documents": [
              {
                "type": "ProofOfIndividualAddress",
                "status": "Pending",
                "id": "4e2581ae-5a31-4499-8f20-fd5ecd5c75f0"
              },
              {
                "type": "ProofOfIdentity",
                "status": "Pending",
                "id": "7ceb8a22-8912-4486-9797-f253f9e0ff28"
              }
            ]
          },
          {
            "info": {
              "__typename": "CompanyShareholder",
              "name": "Company shareholder"
            },
            "status": "PendingOnboarding",
            "id": "ca588da0-bc7a-481d-857f-c3f537a16cf4",
            "onboarding": {
              "id": "3737eed1-ba78-484c-8126-3ccb1042730f"
            },
            "documents": [
              {
                "type": "RegisterExtract",
                "status": "Pending",
                "id": "91517975-65dc-4f00-ac0b-9fe601d38ede"
              },
              {
                "type": "ArticlesOfIncorporation",
                "status": "Pending",
                "id": "4617c161-b33b-42fc-ac77-4f40d12da7ff"
              },
              {
                "type": "CorporateIncomeTaxReturn",
                "status": "Pending",
                "id": "06bfa933-ac8c-4e00-8b3e-492a620807b1"
              },
              {
                "type": "ProofOfIdentity",
                "status": "Pending",
                "id": "50b665be-5ff7-43ac-a8a0-451759f5b261"
              }
            ]
          }
        ],
        "status": "WaitingForRequirements",
        "totalCapitalDepositAmount": {
          "currency": "EUR",
          "value": "10500"
        },
        "updatedAt": "2023-11-02T10:15:42.159Z"
      }
    }
  }
}