Webhooks
Webhooks are a technology used to establish instant communication between different systems and platforms, allowing for the exchange of information and data in real-time. In the context of Fitbank accounts, webhooks are an efficient way to keep clients updated on financial movements in their accounts without having to constantly check the platform. Therefore, when a movement occurs in a Fitbank account, such as a transfer or payment, the webhook is triggered and sends an immediate message to the client's system, informing them about the operation performed. This process is quite useful for clients who need to monitor their accounts in real-time, especially companies that need to manage complex financial flows. In addition, webhooks are highly customizable, allowing clients to configure notifications according to their needs and preferences. This way, it is possible to receive only relevant information for the company's financial management, avoiding the excess of information that can hinder decision-making.
Account's Webhook
Fitbank's account webhooks are responsible for sending messages of approval, disapproval or pending of an account to clients, allowing an instant and efficient communication between platforms. This ensures that customers are informed in real time about the status of their accounts and can act quickly to resolve any pending issues.
| Parameter | Description | Type | Comments |
|---|---|---|---|
| PartnerId | Partner ID provided by Fitbank | Long (number) | None |
| BusinessUnitId | Business Unit ID provided by Fitbank | Long (number) | None |
| TaxNumber | User's Social Security Number (CPF or CNPJ) | String (Text) | None |
| CreationDate | Account Creation Date | DateTime (Date Format) | None |
| AccountStatus | Account Status Indication | Long (number) | Disabled = 0 | Enabled = 1 |
| AccountConditionType | Account Condition Indication | Long (number) | Created = 0 | Limited = 1 | Verified = 2 | Blocked = 3 | Terminated = 4 |
| Bank | Bank Code | String (Text) | None |
| BankBranch | Bank Branch Code | String (Text) | None |
| BankAccount | Bank Account Number | String (Text) | None |
| BankAccountDigit | Account Verified Digit | String (Text) | None |
| AccountKey | Unique account identifier | String (Text) | None |
| SendDate | Webhook send date | DateTime (Date Format) | None |
| SpbAccount | SPB Account Data | Entity | Only needed when a Tax Number has 1 or more SPB account attached. |
| Bank | Bank Code | String (Text) | None |
| BankBranch | Bank Branch Code | String (Text) | None |
| BankAccount | Bank Account Number | String (Text) | None |
| BankAccountDigit | Account Verified Digit | String (Text) | None |
{
"PartnerId": 860,
"BusinessUnitId": 820,
"TaxNumber": "21985454222",
"SendDate": "2022-02-18T15:02:00.6350911-03:00",
"AccountConditionType": 3,
"CreationDate": "2022-02-11T14:11:42.68",
"AccountStatus": 1,
"Bank": null,
"BankBranch": null,
"BankAccount": null,
"BankAccountDigit": null,
"SpbAccount": {
"Bank": "450",
"BankBranch": "0001",
"BankAccount": "00011223",
"BankAccountDigit": "2"
},
"Method": UpdateAccount
}
{
"PartnerId": 85,
"BusinessUnitId": 84,
"TaxNumber": "05333581916",
"SendDate": "0001-01-01T00:00:00",
"AccountConditionType": 0,
"CreationDate": "2022-01-20T08:35:31.06",
"AccountStatus": 1,
"Bank": null,
"BankBranch": null,
"BankAccount": null,
"BankAccountDigit": null,
"AccountKey": "",
"SpbAccount": null,
"Method": UpdateAccount
}
AccountStatus
Disabled = 0 (The account is disabled)
Enabled = 1 (The account is enabled)
AccountConditionType (Account condition indication)
Created = 0 (The account was created)
Limited = 1 (The account is limited)
Verified = 2 (The account is verified)
Blocked = 3 (The account is blocked)
Document's Webhook
The Document's Webhook is an important tool for ensuring smooth and efficient management of documents, and for maintaining clear and transparent communication between all relevant parties. It provides greater visibility into the status of important documents and helps to ensure that they are managed effectively, regardless of any changes or updates that may occur.
| Parameters | Description | Type | Comments |
|---|---|---|---|
| Method | API Method | String (text) | None |
| BusinessUnitId | Business Unit ID Provided by Fitbank | Long (number) | None |
| Account | Account Information Attached to the Document | Entity | None |
| AccountStatus | Account Status Indication | Long (number) | Disabled = 0 || Enabled = 1 |
| AccountConditionType | Account Condition Indication | Long (number) | Created = 0 || Limited = 1 || Verified = 2 || Blocked = 3 || Terminated = 4 |
| TaxNumber | User's Social Security Number (CPF or CNPJ) | String (text) | None |
| HolderTaxNumber | CNPJ/CPF of the account holder. | String | None |
| Bank | Bank Code | String (text) | None |
| BankBranch | Bank Branch Code | String (text) | None |
| BankAccount | Bank Account Number | String (text) | None |
| BankAccountDigit | Account Verified Digit | String (text) | None |
| AccountKey | Unique Account Identifier | String (text) | None |
| Document | Document Information | Entity | None |
| FileName | File Name send through API | String (text) | None |
| Description | Document Description | String (text) | None |
| Extension | Document Extention | String (text) | None |
| ExpirationDate | Document Expiration Date | String (text) | None |
| DocumentStatus | Document Status Indication | Long (number) | AwaitingValidation = 0 || Validated = 1 || Invalid = 2 || Expired = 3 || Sent = 4 || Resubmitted = 5 || Disapproved = 6 || Error = 7 || Inexistent = 8 || Suspended = 9 || TypificationResult = 10 |
| DocumentType | Document Type Indication | Long (number) | IdentityDocumentFront = 0 || TaxNumber = 1 || ProofAddress = 2 || CNH = 3 || CNPJ = 4 || Contract = 5 || LetterOfAttorney = 6 || IdentityDocumentVerse = 7 || DocumentError = 8 || IdentityDocument = 10 |
| DocumentKey | Unique Document Identifier | String (text) | None |
}
"Account": {
"AccountStatus": 1,
"AccountConditionType": 2,
"TaxNumber": "42922460843",
"Bank": "7679",
"BankBranch": "3139",
"BankAccount": "622824",
"BankAccountDigit": "7",
"AccountKey": "860590-254444-7029631-9"
},
"Document": {
"FileName": "42922460843_01072024_CNHVerso.jpeg",
"Description": "Documento_Verso",
"Extension": ".jpeg",
"ExpirationDate": null,
"DocumentStatus": 1,
"DocumentType": 16,
"DocumentKey": "",
"Reason": "",
"TaxNumber": "42922460843",
"Message": "",
"PendingReason": null
},
"Method": "UpdatePersonDocument",
"BusinessUnitId": 4556
}
{
"Account": null,
"Document": {
"FileName": "CNPJ_40450_09032022122937.txt",
"Description": "Documento de teste 1",
"Extension": ".txt",
"ExpirationDate": null,
"DocumentStatus": 0,
"DocumentType": 2,
"DocumentKey": "",
"TaxNumber": "08764039099"
},
"Method": UpdatePersonDocument,
"BusinessUnitId": 40450
}
In the document webhook system, reasons for rejections have been added to be incorporated into the email body. The following messages have been added:
| Reason | Description | Message |
|---|---|---|
| Unreadable Identification Documen | This message is returned when the document provided is illegible for validation. | "The documentation provided is illegible. Please resend the personal identification documents to proceed with the account opening." |
| Identification document not accepted. | This message is returned when the document provided is not what was requested in the requisition, meaning when a document other than the Identity Card (RG) or the National Driver's License (CNH) is provided. | "The identification documentation provided does not match what was requested. Please only send a valid identification, such as the Identity Card (RG) or the National Driver's License (CNH)." |
| Illegible Selfie | This message is returned when the selfie sent is not legible. | "This message is returned when the selfie sent is not legible." |
AccountStatus
Disabled = 0 (The account is disabled)
Enabled = 1 (The account is enabled)
AccountConditionType
Created = 0 (The account was created)
Limited = 1 (The account is limited)
Verified = 2 (The account is verified)
Blocked = 3 (The account is blocked)
Terminated = 4 (The account was closed)
DocumentStatus
AwaitingValidation = 0 (The documentation is awaiting validation)
Validated = 1 (The documentation is validadeted)
Invalid = 2 (The documentation was invalidated)
Expired = 3 (The documentation is expired)
Sent = 4 (The documentation was sent)
Resubmitted = 5 (The documentation was resubmitted)
Disapproved = 6 (The documentation was disapproved)
Error = 7 (Something got wrong with the operation)
Inexistent = 8 (The documentation does not exist)
Suspended = 9 (The documentation was suspended)
TypificationResult = (The documentation was typification)
DocumentType
IdentityDocumentFront = 0 (Front RG)
TaxNumber = 1 (CPF)
ProofAddress = 2 (Proof of address)
CNH = 3 (National Driver's License)
CNPJ = 4 Contract = 5 (National Register of Legal Entities)
LetterOfAttorney = 6 (Power of Attorney)
IdentityDocumentVerse = 7 (Verse RG)
DocumentError = 8 (Document error)
IdentityDocument = 10 (RG)
KYCReport = 12 ("KYC Report")
Other = 13 ("When something was not mapped out, the status 'other' will appears")
Selfie = 14 ("Selfie")
ElectionMinute = 15 ("Ata de Eleição")
CNHVerso = 16 ("CNH Verso")
Account Signer Document's Webhook
The Account Signer Document's Webhook is a technology used by Fitbank to communicate with external systems and platforms regarding updates to account signer documents. When a change is made to an account signer document, such as a new signer being added or removed, the webhook is triggered and sends an immediate message to the external system, informing them of the update.
| Parameter | Description | Type | Comments |
|---|---|---|---|
| Account | Account Information Attached to the Document | Entity | None |
| Document | Document Information | Entity | None |
| FileName | File Name send through API | String (text) | None |
| Description | Document Description | String (text) | None |
| Extension | Document Extention | String (text) | None |
| ExpirationDate | Document Expiration Date | String (text) | None |
| DocumentStatus | Document Status Indication | Long (number) | AwaitingValidation = 0 || Validated = 1 || Invalid = 2 || Expired = 3 || Sent = 4 || Resubmitted = 5 || Disapproved = 6 || Error = 7 || Inexistent = 8 || Suspended = 9 || TypificationResult = 10 |
| DocumentType | Document Type Indication | Long (number) | IdentityDocumentFront = 0 || TaxNumber = 1 || ProofAddress = 2 || CNH = 3 || CNPJ = 4 || Contract = 5 || LetterOfAttorney = 6 || IdentityDocumentVerse = 7 || DocumentError = 8 || IdentityDocument = 10 |
| DocumentKey | Unique Document Identifier | String (text) | None |
| TaxNumber | User's Social Security Number (CPF or CNPJ) | String (text) | None |
| Method | API Method | String (text) | None |
| BusinessUnitId | Business Unit ID Provided by Fitbank | Long (number) | None |
DocumentType
IdentityDocumentFront = 0 (Front RG)
TaxNumber = 1 (CPF)
ProofAddress = 2 (Proof of address)
CNH = 3 (National Driver's License)
CNPJ = 4 Contract = 5 (National Register of Legal Entities)
LetterOfAttorney = 6 (Power of Attorney)
IdentityDocumentVerse = 7 (Verse RG)
DocumentError = 8 (Document error)
IdentityDocument = 10 (RG)
KYCReport = 12 ("KYC Report")
Other = 13 ("When something was not mapped out, the status 'other' will appears")
Selfie = 14 ("Selfie")
Update Person Condition Webhook
The Update Person Condition Webhook is an important tool for ensuring smooth and efficient management of person conditions, and for maintaining clear and transparent communication between all relevant parties. It provides greater visibility into the status of individuals and helps to ensure that they are able to manage their accounts effectively, regardless of any changes in their personal circumstances.
| Parameter | Description | Type | Comments |
|---|---|---|---|
| Method | API Method | String | None |
| BusinessUnitld | Business Unit ID Provided by Fitbank | Long (number) | None |
| PartnerId | Partner ID provided by Fitbank | Long (number) | None |
| Message | Message of the Person Status | String (text) | None |
| MessageClassification | Refers to which final status the person is in | Int | None |
| Taxnumber | User's Social Security Number (CPF or CNPJ) | String (text) | None |
The 'MessageClassification' field must be capable of identifying the scenarios in which the person is placed within Fitbank's KYC model, based on the following table.
| Value | Status | Description |
|---|---|---|
| 0 | Divergent Information | The client provided inconsistent registration information during the account opening process and needs to update the data using the 'changePersonInfo' method. |
| 1 | Rejected | The client did not pass the Fitbank's Know Your Customer (KYC) and Anti-Money Laundering (AML) process and, therefore, cannot proceed with the account opening process. |
| 2 | Internal Disapproved | At this moment, the customer does not meet our internal risk assessment guidelines. They will have the opportunity to attempt account opening again after a period of six months. |
| 3 | Expired Documentation | The client has not undergone the Know Your Customer (KYC) process due to documentation rejection and, therefore, cannot proceed with the account opening process. |
| 4 | Approved Customer | The client was successfully approved. |
{
"TaxNumber": "615.120.612-63",
"PartnerId": 10636,
"Message": "Prezado(a) Cliente, foi constatada uma divergência nos dados enviados para a abertura de conta. Solicitamos, por gentileza, que encaminhe novamente as informações com as correções necessárias. Agradecemos sua compreensão.",
"MessageClassification": 0,
"AccountsKey": [
"669524-655181-5171807-5"
],
"Method": "UpdatePersonCondition",
"BusinessUnitId": 40726
}
{
"TaxNumber": "880.502.850-90",
"PartnerId": 312,
"Message": "Prezado(a) Cliente, após validações internas, não foi possível seguir com a abertura da conta. Agradecemos sua compreensão.",
"MessageClassification": 1,
"AccountsKey": [
"493316-655181-3851480-5"
],
"Method": "UpdatePersonCondition",
"BusinessUnitId": 463
}
{
"TaxNumber": "698.717.682-57",
"PartnerId": 10636,
"Message": "Prezado(a) Cliente, devido as politicas internas da empresa, não foi possível seguir com a abertura da conta. Pedimos que aguarde um prazo de 72 horas para uma nova tentativa. Agradecemos sua compreensão.",
"MessageClassification": 2,
"AccountsKey": [
"669524-655181-5171807-5"
],
"Method": "UpdatePersonCondition",
"BusinessUnitId": 40726
}
{
"TaxNumber": "229.567.260-05",
"PartnerId": 10636,
"Message": "Prezado Cliente. Sua solicitação de abertura de conta expirou por falta de documentação necessária. Para continuar, por favor, refaça sua solicitação. Você pode fazer uma nova solicitação após 72 horas. Agradecemos pela compreensão.",
"MessageClassification": 3,
"AccountsKey": [
"669524-655181-3185832-0"
],
"Method": "UpdatePersonCondition",
"BusinessUnitId": 41003
}
{
"TaxNumber": "893.336.598-20",
"PartnerId": 319,
"Message": "Cliente aprovado com sucesso",
"MessageClassification": 4,
"AccountsKey": [
"669524-655181-5171807-5"
],
"Method": "UpdatePersonCondition",
"BusinessUnitId": 480
}
Update Close Account
Request status at that time
| Parameter | Description | Type | Comments |
|---|---|---|---|
| Method | API Method | String | None |
| BusinessUnitld | Business Unit ID Provided by Fitbank | Long (number) | None |
| CloseAccountInformationStatus | Request status at that time | Long (number) | 0 - Created;1 - Processing; 2 - Error; 3 - Pending; 4 - Disapproved; 5 - Approved; 6 - Automatic Closure Request. |
| Message | Message that informs the customer of the status of the request | String | None |
CloseAccountInformationStatus
0 - Created (Request Created)
1 - Processing (Request Being Processed)
2 - Error (Request Error)
3 - Pending (Request Pending)
4 - Disapproved (Request Desapproved)
5 - Approved (Request Approved)
6 - Automatic Closure Request (Request Automatic Account Closure Scenario)
{
"CloseAccountInformationStatus": 0,
"Message": "Solicitação em análise",
"Bank": "",
"BankAccount": "",
"BankBranch": "",
"BankAccountDigit": "",
"AccountKey": "004390-254444-2865635-2",
"Method": "UpdateCloseAccount",
"BusinessUnitId": 40726
}
{
"CloseAccountInformationStatus": 3,
"Message": "A conta possui saldo remanescente. Para continuar o processo, é necessário retirar o valor excedente",
"Bank": "",
"BankAccount": "",
"BankBranch": "",
"BankAccountDigit": "",
"AccountKey": "004390-254444-2865635-2",
"Method": "UpdateCloseAccount",
"BusinessUnitId": 40726
}
{
"CloseAccountInformationStatus": 3,
"Message": "A conta possui saldo negativo. Para continuar o processo, é necessário liquidar o débito",
"Bank": "",
"BankAccount": "",
"BankBranch": "",
"BankAccountDigit": "",
"AccountKey": "004390-254444-2865635-2",
"Method": "UpdateCloseAccount",
"BusinessUnitId": 40726
}
{
"CloseAccountInformationStatus": 3,
"Message": "Você possui agendamento de pagamentos automáticos em aberto, para prosseguir realize o cancelamento do agendamento",
"Bank": "",
"BankAccount": "",
"BankBranch": "",
"BankAccountDigit": "",
"AccountKey": "004390-254444-2865635-2",
"Method": "UpdateCloseAccount",
"BusinessUnitId": 40726
}
{
"CloseAccountInformationStatus": 4,
"Message": "Solicitação de cancelamento reprovada",
"Bank": "",
"BankAccount": "",
"BankBranch": "",
"BankAccountDigit": "",
"AccountKey": "004390-254444-2865635-2",
"Method": "UpdateCloseAccount",
"BusinessUnitId": 40726
}
{
"CloseAccountInformationStatus": 5,
"Message": "Conta cancelada com sucesso",
"Bank": "",
"BankAccount": "",
"BankBranch": "",
"BankAccountDigit": "",
"AccountKey": "004390-254444-2865635-2",
"Method": "UpdateCloseAccount",
"BusinessUnitId": 40726
}
{
"CloseAccountInformationStatus": 6,
"Message": "Prezado(a) Cliente, informamos que foi iniciado o processo de encerramento automático de sua conta por motivos internos. Pedimos que tente realizar uma nova solicitação de abertura de conta dentro de 72 horas. Agradecemos sua compreensão.",
"Bank": "",
"BankAccount": "",
"BankBranch": "",
"BankAccountDigit": "",
"AccountKey": "004390-254444-2865635-2",
"Method": "UpdateCloseAccount",
"BusinessUnitId": 40726
}
Updated about 1 month ago