Adding Signers
A signer is a person authorized to operate the account of a company. This page explains how to add a signer after the account has already been opened, with the AddSigner method. The inclusion is its own flow, with validation of identity, documents, Compliance, Risk and BC Protege+, and it only takes effect after the final approval. The fields of the methods are in the tables below. All methods also receive the general fields Method, PartnerId and BusinessUnitId. To query signers and requests, see Signers.
Before requesting the inclusion
- The account must be active and unlocked.
- The account holder must be active and verified. Otherwise, the request is denied.
- The signer must be an individual and of legal age. A CNPJ cannot be a signer, and a signer who is a minor is refused.
What to send (AddSigner)
Request fields
In the Requirement column, Mandatory means the field must always be sent, Optional means it can be omitted, and Conditional means it depends on another field, with the condition stated in the Description.
| Field | Requirement | Description |
|---|---|---|
| HolderTaxNumber | Mandatory | CPF or CNPJ of the account holder. |
| AccountKey | Mandatory | Key of the account the signer will be linked to. |
| Justification | Mandatory | Reason for adding the signer, as free text. |
| Signer | Mandatory | Data of the signer. The fields are in the following rows. |
| Signer.Name | Mandatory | Full name of the signer. |
| Signer.TaxNumber | Mandatory | CPF of the signer. |
| Signer.Mail | Mandatory | Email of the signer. |
| Signer.PhoneNumber | Mandatory | Phone of the signer. |
| Signer.MotherFullName | Mandatory | Full name of the mother. |
| Signer.Nationality | Mandatory | Nationality of the signer. |
| Signer.BirthDate | Mandatory | Date of birth. |
| Signer.BirthState | Mandatory | Code of the state of birth, as a number. |
| Signer.PubliclyExposedPerson | Mandatory | Informs whether the signer is a politically exposed person (PEP), with true or false. |
| Signer.PersonRoleType | Mandatory | Role of the signer, as a number. Values in Code Mapping, section Role of the person. |
| Signer.WasSigned | Mandatory | Informs whether the signer accepted the terms. |
| Signer.SignatureDate | Mandatory | Date the terms were signed. |
| Signer.Documents | Mandatory | Documents of the signer, as in Required Documents. |
| Signer.Occupation | Optional | Occupation of the signer. |
| Signer.FatherName | Optional | Name of the father. |
| Signer.SpouseName | Optional | Name of the spouse. |
| Signer.Addresses | Optional | Addresses of the signer. In each address, AddSigner validates AddressLine and AddressType (errors in the Error Catalogue, section AddSigner). |
| Signer.MonthlyIncome | Optional | Monthly income of the signer. |
The role of the signer (PersonRoleType) is required and accepts: 1 (Procurador), 2 (Portador), 3 (Associado) or 4 (Dirigente). Do not send 0 (Holder), which identifies the account holder itself: AddSigner returns EXE0054. The required documents are in Required Documents. The values of PersonRoleType are listed in the Code Mapping, in the section Role of the person.
Response fields
| Field | Description |
|---|---|
| Success | "true" or "false". |
| Message | Return message, described in the Success Catalogue. |
| USN | Identifier of the request. Use it in GetRequestSigner and to relate the webhook to the request. |
How the analysis works
Fits evaluates the request within 48 hours. The inclusion only takes effect after the final approval.
flowchart TD
A["The BU sends the signer data and documents"] --> B["Fits verifies the account holder"]
B --> C["Signer KYC"]
C --> D["BC Protege+ query"]
D --> E["Compliance and Risk analysis of the link with the company"]
E --> F{"Result in the signer webhook"}
F -- Aprovado --> G["The BU updates the signer link"]
F -- Reprovado --> H["The BU does not link the signer and evaluates the cause"]
How to track the result
A successful API response only confirms that the request was received. The result arrives through the signer webhook, with the status Gerada, Aprovado or Reprovado (Method FBWebhookWorkerUpdateSignerSolicitation). The Gerada notice is not sent in every case. To query the request at any time, use GetRequestSigner.
| Result | What the BU must do |
|---|---|
| Aprovado | Update the signer link in the BU system, only after receiving the final return. |
| Reprovado | Do not link the signer and evaluate the cause, checking the webhook and GetRequestSigner. |
GetRequestSigner
GetRequestSigner queries the status of a signer inclusion request made with AddSigner.
Request fields
| Field | Requirement | Description |
|---|---|---|
| USN | Mandatory | Identifier of the request, returned by AddSigner. |
Response fields
| Field | Description |
|---|---|
| Success | "true" or "false". |
| RequestStatus | Status of the request, as text, such as Gerada, Sob análise interna, Aprovado, Reprovado or Pendente de Documentos. See the Code Mapping, section Signer request status. |
| USN | Identifier of the request. |
| HolderData | Data of the account holder. |
| HolderData.TaxNumber | CPF or CNPJ of the holder. |
| HolderData.TrandingName | Trade name of the holder. |
| HolderData.ConstitutionDate | Constitution date of the holder. |
| SignatoryData | Data of the requested signer. |
| SignatoryData.Name | Name of the signer. |
| SignatoryData.TaxNumber | CPF of the signer. |
| SignatoryData.BirthDate | Date of birth of the signer. |
| SignatoryData.PersonRoleType | Role of the signer, as text, such as Procurador, Portador, Associado or Dirigente. |
| SignatoryData.Justification | Reason given at the inclusion, as free text. |
The errors of GetRequestSigner are listed in the Error Catalogue, in the section "GetSigners and GetRequestSigner".
BC Protege+
Fits queries BC Protege+ when a signer is added. If a single signer has an active restriction, the request may be disapproved, and this may affect the company account. In that case, the customer must check and regularize the protection on the gov.br environment before a new request. See more in BC Protege+.
The errors returned by this method are listed in the Error Catalogue, in the section AddSigner.
How to handle the inclusion
- Check the conditions of the account and of the holder before calling the method.
- Send all the required data and documents at once.
- Store the USN and relate it to the original request, together with the TaxNumber, the account, the method, the payload, the response and the webhooks.
- Update the signer link only with the final return of the webhook.
- If the webhook does not arrive, query the request with GetRequestSigner before asking again.
Updated 11 days ago

