💡A API FINCEN (Financial Crimes Enforcement Network) permite consultar informações da agência do Departamento do Tesouro dos Estados Unidos responsável por prevenir e combater crimes financeiros, como lavagem de dinheiro, financiamento ao terrorismo e outras atividades ilícitas relacionadas ao sistema financeiro.
Introdução
A API FINCEN fornece acesso a informações cruciais para:
- Prevenção de lavagem de dinheiro
- Combate ao financiamento do terrorismo
- Monitoramento de atividades financeiras suspeitas
- Verificação de empresas registradas como Money Service Business (MSB)
- Compliance com regulamentações financeiras americanas
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br
Endpoint
FINCEN
GET /api/FinCEN
Descrição: Endpoint para realizar a consulta FINCEN - Financial Crimes Enforcement Network.
Autenticação
Para acessar esta API, é necessário fornecer um token de autenticação.
Regras de Autenticação:
- O token deve ser enviado como parâmetro na URL da requisição.
- O token é obrigatório para realizar consultas.
- Em caso de dúvidas sobre o token, entre em contato com: suporte@directd.com.br
Campos da API
Dados da Empresa
- Número MSB: Identificador único do Money Service Business
- Razão Social: Nome oficial da empresa
- Nome Fantasia: Nome comercial da empresa
- Data Assinatura Autorizada: Data da assinatura autorizada
- Data de Recebimento: Data de recebimento do registro
- Quantidade de Filiais: Número de filiais da empresa
Serviço Monetário
- Número: Identificador do serviço
- Atividades: Lista de atividades autorizadas
- Lista de Estados: Estados onde opera
- Lista de Estados e Territórios: Jurisdições completas
Localização
- Endereço: Endereço completo
- Cidade: Cidade da empresa
- Estado: Estado da empresa
- Código Postal: CEP/ZIP code
- País: País de operação
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| NOME | string | Sim | Nome da empresa. Pode ser enviado em maiúsculo ou minúsculo. |
| TOKEN | string | Sim | Token de autenticação necessário para a consulta. |
Exemplos de Requisição
Usando cURL
curl 'https://apiv3.directd.com.br/api/FinCEN?NOME=Example%20Company&TOKEN=seu_token_aqui'
Respostas
Sucesso (200)
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"nomeConsultado": "string",
"resultadosEncontrados": 0,
"empresas": [
{
"numeroMSB": "string",
"razaoSocial": "string",
"nomeFantasia": "string",
"dataAssinaturaAutorizada": "string",
"dataRecebimento": "string",
"quantidadeFiliais": 0,
"servicoMonetario": {
"numero": "string",
"atividades": [
"string"
],
"estados": [
"string"
],
"estadosTerritorios": [
"string"
]
},
"localizacao": {
"endereco": "string",
"cidade": "string",
"estado": "string",
"codigoPostal": "string",
"pais": "string"
}
}
]
}
}
Outros Códigos de Resposta
| Código | Descrição |
|---|---|
| 201 | Sucesso: a requisição async foi criada com sucesso e está em processamento. |
| 202 | Em Processamento: a requisição async ainda está em processamento. |
| 400 | Requisição Inválida: a requisição está incorreta ou os parâmetros são inválidos. |
| 401 | Não Autenticado: o usuário não forneceu as credenciais corretas para acessar o recurso. |
| 403 | Não Autorizado: o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| 404 | Não Encontrado: o servidor não encontrou uma representação atual do recurso solicitado. |
| 408 | Tempo Esgotado: o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| 500 | Falha ao Realizar Consulta: o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| 503 | Consulta em Manutenção: a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |
Aplicações
- Análise de Risco/Crédito
- Prevenção de Roubo de Identidade
- Compliance Internacional
- Due Diligence
- Prevenção à Lavagem de Dinheiro
- Monitoramento de Atividades Suspeitas
Notas Importantes
- O valor da consulta é de R$ 0,36
- Permite gerar comprovante em PDF (adicional de 50% do valor da consulta)
- A API está na versão v3
- Para suporte técnico, entre em contato com suporte@directd.com.br
- Fonte oficial: https://www.fincen.gov/msb-state-selector