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. onboardingCapitalDepositCompany
2. companyName: Enter the name of the future company (line 4).
3. companyShareholders: Add required information about company shareholders (starts on line 6).
   1. Add the capitalDepositAmount the company shareholder deposits (starts on line 7).
   2. Add the onboardingInfo object to prefill the company shareholder's onboarding information (starts on line 13).
   3. Add the accountCountry value (mandatory) and select the country code of the account's local IBAN (line 14).
   4. Prefill information about the company shareholder's individualUltimateBeneficialOwners (starts on line 53) and representatives (starts on line 78).
4. individualShareholders: Add required information about individual shareholders (starts on line 101), including their capitalDepositAmount (starts on line 107) and onboardingInfo (starts on line 112).
5. onboardingCapitalDepositCompany: Add the company onboarding object to start creating the future company account (starts on line 137).
   Match your shareholder data

   Every person listed in individualUltimateBeneficialOwners (starts on line 174) and representatives (starts on line 221) must match the shareholder information entered in steps 3 and 4.

6. Add the CreateCapitalDepositCaseSuccessPayload (starts on line 244). Consider adding several pieces of important information, such as:
   1. companyOnboarding > id (starts on line 248).
   2. statusInfo > status (starts on line 251).
   3. totalCapitalDepositAmount (starts on line 258).
7. Add rejections in case the mutation doesn't succeed (start on line 264).

Mutation

Open in API Explorer

mutation CreateCapitalDeposit {
  createCapitalDepositCase(
    input: {
      companyName: "MyBrand"

      companyShareholders: {
        capitalDepositAmount: {
          value: "500"
          currency: "EUR"
        }
        name: "MyBrand Company Shareholder"

        onboardingInfo: {
          accountCountry: FRA
          accountName: "MyBrand Company Shareholder Capital Deposit Account"
          acquisitionChannel: OutboundAccountingFirm
          businessActivity: BusinessAndRetail
          businessActivityDescription: "Establishment that serves traditional French cuisine."
          companyType: Company
          email: "companyshareholder@mybrand.fr"
          isRegistered: true
          language: "fr"
          monthlyPaymentVolume: Between50000And100000
          name: "MyBrand Company Shareholder"
          registrationNumber: "853827103"
          taxIdentificationNumber: "853827103"
          tradeName: "MyBrand CS"
          typeOfRepresentation: LegalRepresentative
          vatNumber: "FR90853827103"

          oAuthRedirectParameters: {
            redirectUrl: "https://www.mybrand.fr"
          }

          residencyAddress: {
            addressLine1: "91 rue du Faubourg Saint-Honoré"
            addressLine2: "Batiment A"
            country: "FRA"
            city: "Paris"
            postalCode: "75008"
            state: "Ile de France"
          }

          legalRepresentativePersonalAddress: {
            addressLine1: "10 rue Duris"
            addressLine2: "Batiment A"
            country: "FRA"
            city: "Paris"
            postalCode: "75020"
            state: "Ile de France"
          }

          individualUltimateBeneficialOwners: [
            {
              firstName: "Jules"
              lastName: "Fleury"
              birthDate: "1990-06-01"
              birthCity: "Paris"
              birthCityPostalCode: "75007"
              birthCountryCode: "FRA"
              gender: Male
              direct: true
              indirect: false
              totalCapitalPercentage: 100
              type: HasCapital
              taxIdentificationNumber: "1221112"
              residencyAddress: {
                addressLine1: "10 rue Duris"
                addressLine2: "Batiment A"
                country: "FRA"
                city: "Paris"
                postalCode: "75020"
                state: "Ile de France"
              }
            }
          ]

          representatives: {
            type: Individual
            roles: "President"
            firstName: "Jules"
            lastName: "Fleury"
            birthDate: "1990-06-01"
            birthCity: "Paris"
            birthCityPostalCode: "75007"
            birthCountryCode: "FRA"
            gender: Male
            nationality: "FRA"
            residencyAddress: {
              addressLine1: "10 rue Duris"
              addressLine2: "Batiment A"
              country: "FRA"
              city: "Paris"
              postalCode: "75020"
              state: "Ile de France"
            }
          }
        }
      }

      individualShareholders: {
        firstName: "Henri"
        lastName: "Dupont"
        birthDate: "1988-02-25"
        nationality: "FRA"

        capitalDepositAmount: {
          value: "500"
          currency: "EUR"
        }

        onboardingInfo: {
          accountCountry: FRA
          accountName: "Henri Dupont Capital Deposit Account"
          acquisitionChannel: OutboundAccountingFirm
          email: "henri.dupont@mybrand.fr"
          employmentStatus: Entrepreneur
          language: "fr"
          monthlyIncome: MoreThan4500
          taxIdentificationNumber: "1122211"

          oAuthRedirectParameters: {
            redirectUrl: "https://www.mybrand.fr"
          }

          residencyAddress: {
            addressLine1: "24 Rue Saint-Ambroise"
            addressLine2: "Batiment A"
            country: "FRA"
            city: "Paris"
            postalCode: "75011"
            state: "Ile de France"
          }
        }
      }

      onboardingCapitalDepositCompany: {
        accountCountry: FRA
        accountName: "MyBrand Account"
        acquisitionChannel: OutboundAccountingFirm
        businessActivity: BusinessAndRetail
        businessActivityDescription: "Establishment that serves traditional French cuisine."
        companyType: Company
        email: "bonjour@mybrand.fr"
        isRegistered: false
        language: "fr"
        monthlyPaymentVolume: Between50000And100000
        name: "MyBrand"
        tradeName: "MB"
        typeOfRepresentation: LegalRepresentative

        oAuthRedirectParameters: {
          redirectUrl: "https://www.mybrand.fr"
        }

        residencyAddress: {
          addressLine1: "168 Rue Saint-Maur"
          addressLine2: "Batiment A"
          country: "FRA"
          city: "Paris"
          postalCode: "75011"
          state: "Ile de France"
        }

        legalRepresentativePersonalAddress: {
          addressLine1: "10 rue Duris"
          addressLine2: "Batiment A"
          country: "FRA"
          city: "Paris"
          postalCode: "75020"
          state: "Ile de France"
        }

        individualUltimateBeneficialOwners: [
          {
            firstName: "Henri"
            lastName: "Dupont"
            birthDate: "1988-02-25"
            birthCity: "Paris"
            birthCityPostalCode: "75008"
            birthCountryCode: "FRA"
            gender: Male
            direct: true
            indirect: false
            totalCapitalPercentage: 50
            type: HasCapital
            taxIdentificationNumber: "1122211"
            residencyAddress: {
              addressLine1: "24 Rue Saint-Ambroise"
              addressLine2: "Batiment A"
              country: "FRA"
              city: "Paris"
              postalCode: "75011"
              state: "Ile de France"
            }
          }
          {
            firstName: "Jules"
            lastName: "Fleury"
            birthDate: "1990-06-01"
            birthCity: "Paris"
            birthCityPostalCode: "75007"
            birthCountryCode: "FRA"
            gender: Male
            direct: false
            indirect: true
            totalCapitalPercentage: 50
            type: HasCapital
            taxIdentificationNumber: "1221112"
            residencyAddress: {
              addressLine1: "10 rue Duris"
              addressLine2: "Batiment A"
              country: "FRA"
              city: "Paris"
              postalCode: "75020"
              state: "Ile de France"
            }
          }
        ]

        representatives: {
          type: Individual
          roles: "President"
          firstName: "Jules"
          lastName: "Fleury"
          birthDate: "1990-06-01"
          birthCity: "Paris"
          birthCityPostalCode: "75007"
          birthCountryCode: "FRA"
          gender: Male
          nationality: "FRA"
          residencyAddress: {
            addressLine1: "10 rue Duris"
            addressLine2: "Batiment A"
            country: "FRA"
            city: "Paris"
            postalCode: "75020"
            state: "Ile de France"
          }
        }
      }
    }
  ) {
    ... on CreateCapitalDepositCaseSuccessPayload {
      __typename
      capitalDepositCase {
        id
        companyOnboarding {
          id
        }
        statusInfo {
          status
          ... on CapitalDepositCaseWaitingForInitialRequirementsStatusInfo {
            __typename
            status
          }
        }
        totalCapitalDepositAmount {
          currency
          value
        }
      }
    }
    ... on ForbiddenRejection {
      __typename
      message
    }
    ... on BadRequestRejection {
      __typename
      message
    }
    ... on ValidationRejection {
      __typename
      fields {
        code
        message
        path
      }
      message
    }
    ... on InternalErrorRejection {
      __typename
      message
    }
  }
}

Payload

The options selected in the mutation example produce the following success payload.

Onboardings start with the information you prefilled. They're completed later in the capital deposit process.

Note several pieces of key information:

1. Your capital deposit case id (line 6).
2. Your company onboarding id (line 8).
3. Status of the entire capital deposit case (lines 10-13).
4. Total capital deposit amount, which the API calculates from all shareholders' amounts (lines 14-17).

Queries

This information can 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": {
      "__typename": "CreateCapitalDepositCaseSuccessPayload",
      "capitalDepositCase": {
        "id": "$CAPITAL_DEPOSIT_CASE_ID",
        "companyOnboarding": {
          "id": "$COMPANY_ONBOARDING_ID"
        },
        "statusInfo": {
          "status": "WaitingForInitialRequirements",
          "__typename": "CapitalDepositCaseWaitingForInitialRequirementsStatusInfo"
        },
        "totalCapitalDepositAmount": {
          "currency": "EUR",
          "value": "1000"
        }
      }
    }
  }
}