Guia Inicial
Guia do Desenvolvedor
- Guia de Integração Via API
Referências de API
- Crédito
- Cadastral
- DataBusca
- Emailage
Emailage
Consultar Dados de Lote de E-mail
Copy
Ask AI
curl --request POST \
--url https://api.bmpdigital.moneyp.dev.br/Bureau/ConsultarEmailageLote \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--header 'IdempotencyKey: <idempotencykey>' \
--data '{
"webhookId": "<string>",
"consulta": [
{
"email": "<string>",
"primeiroNome": "<string>",
"sobrenome": "<string>",
"codPais": "<string>",
"telefone": "<string>",
"idRastreamento": "<string>",
"idTransacao": "<string>",
"endCobrancaRua": "<string>",
"endCobrancaCidade": "<string>",
"endCobrancaEstado": "<string>",
"endCobrancaCEP": "<string>",
"endCobrancaPais": "<string>",
"endEntregaRua": "<string>",
"endEntregaCidade": "<string>",
"endEntregaEstado": "<string>",
"endEntregaCEP": "<string>",
"endEntregaPais": "<string>",
"identificacaoDoCliente": "<string>",
"idDispositivo": "<string>",
"localizacaoDoServico": "<string>"
}
]
}'
Copy
Ask AI
{
"msg": "<string>",
"messages": [
{
"messageType": 1,
"code": "<string>",
"context": "<string>",
"description": "<string>",
"field": "<string>"
}
],
"hasError": true,
"falha": true,
"json": "<string>"
}
Este endpoint tem como objetivo realizar uma validação de risco utilizando o e-mail como campo obrigatório, juntamente com outras informações complementares, para obter o score de confiabilidade daquele e-mail.
O uso deste serviço é destinado ao processamento em lote.
Show Exemplo de retorno completo
Show Exemplo de retorno completo
O exemplo de retorno, mostrado no lado direito desta tela, está resumido. No linha "json": "<string>"
o retorno do Bureau vem de forma serializada, sendo necessário deserializar para melhor visualização. Aqui está um exemplo do retorno deserializado que vem no campo "json":
.
Copy
Ask AI
[
{
\"userdefinedrecordid": " ",
\"email": "jose@pro.com.br",
\"ipaddress": null,
\"eName": " ",
\"emailAge": " ",
\"email_creation_days": " ",
\"domainAge": "2017-05-27T00:00:00Z",
\"domain_creation_days": "2923",
\"firstVerificationDate ": "2023-07-05T15:49:45Z",
\"first_seen_days": "692",
\"lastVerificationDate": "2025-05-28T14:13:55Z",
\"status": "Verified",
\"country": "BR",
\"fraudRisk": "209 Low",
\"EAScore": "209",
\"EAReason": "Email Created at least 1.9 Years Ago",
\"EAStatusID": "2",
\"EAReasonID ": 14,
\"EAAdviceID": "3",
\"EAAdvice": "Lower Fraud Risk",
\"EARiskBandID": "2",
\"EARiskBand": "Fraud Score 101 to 300",
\"dob": " ",
\"gender": " ",
\"location": " ",
\"smfriends": " ",
\"totalhits": "6",
\"uniquehits": "1",
\"imageurl": " ",
\"emailExists": "Yes",
\"domainExists": "Yes",
\"company": " ",
\"title": " ",
\"billriskcountry": null,
\"source_industry": " ",
\"fraud_type": " ",
\"fraudemail": null,
\"fraudphone": null,
\"fraudaddress": null,
\"fraudpostal": null,
\"fraudpostalXml": null,
\"fraudzip": null,
\"addressmatch": null,
\"postalcity": null,
\"postalregion": null,
\"transidentifier": null,
\"customeridentifiermatch": null,
\"namematch": null,
\"domainname": "fulltechpro.com.br",
\"domaincompany": " ",
\"domaincountryname": "Brazil",
\"domaincategory": " ",
\"domaincorporate": " ",
\"domainrisklevel": "Moderate",
\"domainrelevantinfo": "Valid Domain from Brazil",
\"domainrisklevelID": "3",
\"domainrelevantinfoID": "508",
\"domaincountrymatch": null,
\"domainriskcountry": "No",
\"smlinks": [],
\"ip_risklevelid": null,
\"ip_risklevel": null,
\"ip_riskreasonid": null,
\"ip_riskreason": null,
\"ip_reputation": null,
\"ip_anonymousdetected": null,
\"ip_isp": null,
\"ip_org": null,
\"ip_userType": null,
\"ip_netSpeedCell": null,
\"ip_corporateProxy": null,
\"ip_continentCode": null,
\"ip_country": null,
\"ip_countryCode": null,
\"ip_countryconf": null,
\"ip_region": null,
\"ip_regionconf": null,
\"ip_city": null,
\"ip_cityconf": null,
\"ip_postalcode": null,
\"ip_postalconf": null,
\"ip_callingcode": null,
\"ip_metroCode": null,
\"ip_riskscore": null,
\"ip_latitude": null,
\"ip_longitude": null,
\"ip_map": null,
\"ipcountrymatch": null,
\"ipriskcountry": null,
\"ipdistancekm": null,
\"ipdistancekmXml": null,
\"ipdistancemil": null,
\"ipdistancemilXml": null,
\"ipaccuracyradius": null,
\"ipaccuracyradiuslXml": null,
\"iptimezone": null,
\"ipasnum": null,
\"ipdomain": null,
\"custphoneInbillingloc": null,
\"shipforward": "No",
\"citypostalmatch": null,
\"shipcitypostalmatch": null,
\"deviceIdRiskLevel": null,
\"lastflaggedon": " ",
\"phone_status": "Valid",
\"phoneowner": null,
\"phoneownertype": null,
\"phonecarriertype": "invalid",
\"phonecarriernetworkcode": null,
\"phonecarriername": " ",
\"phoneownermatch": null,
\"ip_proxytype”: null,
\"ip_proxydescription": null,
\"issuerBank": null,
\"issuerBrand": null,
\"issuerCountry": null,
\"cardCategory": null,
\"cardType": null,
\"overallDigitalIdentityScore": 46,
\"overallDigitalIdentityScoreXml": "46",
\"emailToIpConfidence": null,
\"emailToIpConfidenceXml": null,
\"emailToPhoneConfidence": 46,
\"emailToPhoneConfidenceXml": "46",
\"emailToBillAddressConfidence": null,
\"emailToBillAddressConfidenceXml": null,
\"emailToShipAddressConfidence": null,
\"emailToShipAddressConfidenceXml": null,
\"emailToFullNameConfidence": null,
\"emailToFullNameConfidenceXml": null,
\"emailToLastNameConfidence": null,
\"emailToLastNameConfidenceXml": null,
\"ipToPhoneConfidence": null,
\"ipToPhoneConfidenceXml": null,
\"ipToBillAddressConfidence": null,
\"ipToBillAddressConfidenceXml": null,
\"ipToShipAddressConfidence": null,
\"ipToShipAddressConfidenceXml": null,
\"ipToFullNameConfidence": null,
\"ipToFullNameConfidenceXml": null,
\"ipToLastNameConfidence": null,
\"ipToLastNameConfidenceXml": null,
\"phoneToBillAddressConfidence": null,
\"phoneToBillAddressConfidenceXml": null,
\"phoneToShipAddressConfidence": null,
\"phoneToShipAddressConfidenceXml": null,
\"phoneToFullNameConfidence": null,
\"phoneToFullNameConfidenceXml": null,
\"phoneToLastNameConfidence": null,
\"phoneToLastNameConfidenceXml": null,
\"billAddressToFullNameConfidence": null,
\"billAddressToFullNameConfidenceXml": null,
\"billAddressToLastNameConfidence": null,
\"billAddressToLastNameConfidenceXml": null,
\"shipAddressToBillAddressConfidence": null,
\"shipAddressToBillAddressConfidenceXml": null,
\"shipAddressToFullNameConfidence": null,
\"shipAddressToFullNameConfidenceXml": null,
\"shipAddressToLastNameConfidence": null,
\"shipAddressToLastNameConfidenceXml": null,
\"disDescription": "Moderate Confidence",
\"standardizedBillingAddress": null,
\"standardizedShippingAddress": null,
\"custom1": null,
\"custom2": null,
\"custom3": null,
\"custom4": null,
\"custom5": null,
\"custom6": null,
\"custom7": null,
\"trackingId": null,
\"ipShipCountryMatch": null,
\"ipShipDistanceMil": null,
\"ipShipDistanceMilXml": null,
\"ipShipDistanceKm": null,
\"ipShipDistanceKmXml": null,
\"correlationId": null,
\"transAmount": null,
\"transAmountXml": null,
},
{
\"userdefinedrecordid": " ",
\"email": "jose@pro.com.br",
\"ipaddress": null,
\"eName": " ",
\"emailAge": " ",
\"email_creation_days": " ",
\"domainAge": "2017-05-27T00:00:00Z",
\"domain_creation_days": "2923",
\"firstVerificationDate ": "2023-07-05T15:49:45Z",
\"first_seen_days": "692",
\"lastVerificationDate": "2025-05-28T14:13:55Z",
\"status": "Verified",
\"country": "BR",
\"fraudRisk": "209 Low",
\"EAScore": "209",
\"EAReason": "Email Created at least 1.9 Years Ago",
\"EAStatusID": "2",
\"EAReasonID ": 14,
\"EAAdviceID": "3",
\"EAAdvice": "Lower Fraud Risk",
\"EARiskBandID": "2",
\"EARiskBand": "Fraud Score 101 to 300",
\"dob": " ",
\"gender": " ",
\"location": " ",
\"smfriends": " ",
\"totalhits": "6",
\"uniquehits": "1",
\"imageurl": " ",
\"emailExists": "Yes",
\"domainExists": "Yes",
\"company": " ",
\"title": " ",
\"billriskcountry": null,
\"source_industry": " ",
\"fraud_type": " ",
\"fraudemail": null,
\"fraudphone": null,
\"fraudaddress": null,
\"fraudpostal": null,
\"fraudpostalXml": null,
\"fraudzip": null,
\"addressmatch": null,
\"postalcity": null,
\"postalregion": null,
\"transidentifier": null,
\"customeridentifiermatch": null,
\"namematch": null,
\"domainname": "fulltechpro.com.br",
\"domaincompany": " ",
\"domaincountryname": "Brazil",
\"domaincategory": " ",
\"domaincorporate": " ",
\"domainrisklevel": "Moderate",
\"domainrelevantinfo": "Valid Domain from Brazil",
\"domainrisklevelID": "3",
\"domainrelevantinfoID": "508",
\"domaincountrymatch": null,
\"domainriskcountry": "No",
\"smlinks": [],
\"ip_risklevelid": null,
\"ip_risklevel": null,
\"ip_riskreasonid": null,
\"ip_riskreason": null,
\"ip_reputation": null,
\"ip_anonymousdetected": null,
\"ip_isp": null,
\"ip_org": null,
\"ip_userType": null,
\"ip_netSpeedCell": null,
\"ip_corporateProxy": null,
\"ip_continentCode": null,
\"ip_country": null,
\"ip_countryCode": null,
\"ip_countryconf": null,
\"ip_region": null,
\"ip_regionconf": null,
\"ip_city": null,
\"ip_cityconf": null,
\"ip_postalcode": null,
\"ip_postalconf": null,
\"ip_callingcode": null,
\"ip_metroCode": null,
\"ip_riskscore": null,
\"ip_latitude": null,
\"ip_longitude": null,
\"ip_map": null,
\"ipcountrymatch": null,
\"ipriskcountry": null,
\"ipdistancekm": null,
\"ipdistancekmXml": null,
\"ipdistancemil": null,
\"ipdistancemilXml": null,
\"ipaccuracyradius": null,
\"ipaccuracyradiuslXml": null,
\"iptimezone": null,
\"ipasnum": null,
\"ipdomain": null,
\"custphoneInbillingloc": null,
\"shipforward": "No",
\"citypostalmatch": null,
\"shipcitypostalmatch": null,
\"deviceIdRiskLevel": null,
\"lastflaggedon": " ",
\"phone_status": "Valid",
\"phoneowner": null,
\"phoneownertype": null,
\"phonecarriertype": "invalid",
\"phonecarriernetworkcode": null,
\"phonecarriername": " ",
\"phoneownermatch": null,
\"ip_proxytype”: null,
\"ip_proxydescription": null,
\"issuerBank": null,
\"issuerBrand": null,
\"issuerCountry": null,
\"cardCategory": null,
\"cardType": null,
\"overallDigitalIdentityScore": 46,
\"overallDigitalIdentityScoreXml": "46",
\"emailToIpConfidence": null,
\"emailToIpConfidenceXml": null,
\"emailToPhoneConfidence": 46,
\"emailToPhoneConfidenceXml": "46",
\"emailToBillAddressConfidence": null,
\"emailToBillAddressConfidenceXml": null,
\"emailToShipAddressConfidence": null,
\"emailToShipAddressConfidenceXml": null,
\"emailToFullNameConfidence": null,
\"emailToFullNameConfidenceXml": null,
\"emailToLastNameConfidence": null,
\"emailToLastNameConfidenceXml": null,
\"ipToPhoneConfidence": null,
\"ipToPhoneConfidenceXml": null,
\"ipToBillAddressConfidence": null,
\"ipToBillAddressConfidenceXml": null,
\"ipToShipAddressConfidence": null,
\"ipToShipAddressConfidenceXml": null,
\"ipToFullNameConfidence": null,
\"ipToFullNameConfidenceXml": null,
\"ipToLastNameConfidence": null,
\"ipToLastNameConfidenceXml": null,
\"phoneToBillAddressConfidence": null,
\"phoneToBillAddressConfidenceXml": null,
\"phoneToShipAddressConfidence": null,
\"phoneToShipAddressConfidenceXml": null,
\"phoneToFullNameConfidence": null,
\"phoneToFullNameConfidenceXml": null,
\"phoneToLastNameConfidence": null,
\"phoneToLastNameConfidenceXml": null,
\"billAddressToFullNameConfidence": null,
\"billAddressToFullNameConfidenceXml": null,
\"billAddressToLastNameConfidence": null,
\"billAddressToLastNameConfidenceXml": null,
\"shipAddressToBillAddressConfidence": null,
\"shipAddressToBillAddressConfidenceXml": null,
\"shipAddressToFullNameConfidence": null,
\"shipAddressToFullNameConfidenceXml": null,
\"shipAddressToLastNameConfidence": null,
\"shipAddressToLastNameConfidenceXml": null,
\"disDescription": "Moderate Confidence",
\"standardizedBillingAddress": null,
\"standardizedShippingAddress": null,
\"custom1": null,
\"custom2": null,
\"custom3": null,
\"custom4": null,
\"custom5": null,
\"custom6": null,
\"custom7": null,
\"trackingId": null,
\"ipShipCountryMatch": null,
\"ipShipDistanceMil": null,
\"ipShipDistanceMilXml": null,
\"ipShipDistanceKm": null,
\"ipShipDistanceKmXml": null,
\"correlationId": null,
\"transAmount": null,
\"transAmountXml": null,
}
]
Tabelas
Show Tabela de faixas de risco
Show Tabela de faixas de risco
Score de Risco | Nível | Descrição |
---|---|---|
1 - 100 | Risco mais baixo | Nesta categoria, o endereço de e-mail normalmente existe há pelo menos quatro anos e estabeleceu um padrão de sinais positivos em todo o mundo. Os clientes com esse tipo de e-mail podem ser acelerados ou aprovados automaticamente em seu sistema. |
101 - 300 | Risco mínimo | O endereço de e-mail existe há um ou dois anos e tem outros sinais positivos associados a um endereço IP ou outro fator que é passado para a Emailage. Esses endereços representam muito pouco risco e podem ser aprovados, dependendo de outras circunstâncias que envolvem a transação ou cliente. |
301 - 600 | Risco neutro | Nenhum indicador negativo está associado às informações de entrada. No entanto, indicadores positivos não são suficientes para categorizar a transação como de menor risco. |
601 - 799 | Registro incorreto do e-mail | Preenchimento incorretamente, o endereço de email, tornando-o inválido ou incorreto. |
800 - 899 | Alto risco | A consulta é considerada arriscada devido a padrões de velocidade, sinais de endereços IP arriscados conhecidos ou detalhes da transação que refletem um histórico de suspeita de fraude na rede. |
900 - 999 | Risco muito alto | A transação é confirmada como fraudulenta ou associada a um alto nível de sinais de risco. Você deve revisar ou rejeitar manualmente |
Show Tabela de descrição dos campos da requisição
Show Tabela de descrição dos campos da requisição
Variável | Descrição | Preenchimento esperado |
---|---|---|
email | O endereço de e-mail do cliente (Preenchimento obrigatório). | email-de-exemplo@mail.com |
PrimeiroNome | O primeiro nome do cliente. | Nome |
Sobrenome | O sobrenome do cliente. | Sobrenome |
Telefone | Informar o código do estado e complementar com o número de contato. | Celular: 11932244000/ Fixo: 1132244000 |
ddi | Informar o DDI do país, podendo ser repassado até três números. | DDI: 55 ou 123 |
IdentificacaoDoCliente | ID para identificação do cliente. | afd04b85-6b2e-494e-a87f15406928380a |
EnderecoDeCobrancaRua | O endereço de cobrança do cliente. | 123 Avenida paulista |
EnderecoDeCobrancaCidade | A cidade de faturamento para o cliente. | Sao Paulo |
EnderecoDeCobrancaEstado | O estado ou a região de cobrança do cliente. | Sao Paulo |
EnderecoDeCobrancaCep | O CEP de cobrança do cliente. | 39765000 |
EnderecoDeCobrancaPais | O país de cobrança do cliente. Valores possíveis: Nome completo do país. Código de país de duas letras. | Brasil ou BR |
EnderecoDeEntregaRua | O endereço de entrega. | 150 Pamplona |
EnderecoDeEntregaCidade | A cidade do endereço de entrega. | Sao Paulo |
EnderecoDeEntregaEstado | A região ou o estado do endereço de entrega. | Sao Paulo |
EnderecoDeEntregaCep | O CEP do endereço de entrega. | 1405000 |
EnderecoDeEntregaPais | O país de envio do cliente. Valores possíveis: Nome completo do país. Código de país de duas letras. | Brasil ou BR |
IdTransacao | ID de registro definido pelo usuário. Esse parâmetro pode ser usado quando você deseja adicionar um identificador para uma consulta. Esse identificador é retornado com os resultados. | b5c78837-bb8d-4bdf-b44e0d1a9235b014 |
LocalizacaoDoServico | Esse valor se aplica a diferentes tipos de serviço: Viajar - Rota de voo. Hospitalidade - Localização do hotel. Emissão de ingressos - Local do evento. Tecnologia/Finanças/Comércio Eletrônico - A localização do serviço/canal/perfil final. | Exemplo: “Transporte do metro sentido centro” |
IdDispositivo | ID do dispositivo do cliente, conforme definido pelo fabricante do dispositivo. | 1653b405-5620-4f6f-a37df3867fce200c |
IdRastreamento | Esse campo pode ser usado quando você deseja adicionar um identificador interno do sistema. |
Authorizations
Informe o token
Headers
Body
Response
200
text/plain
Success
The response is of type object
.
Esta página foi útil?
Copy
Ask AI
curl --request POST \
--url https://api.bmpdigital.moneyp.dev.br/Bureau/ConsultarEmailageLote \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--header 'IdempotencyKey: <idempotencykey>' \
--data '{
"webhookId": "<string>",
"consulta": [
{
"email": "<string>",
"primeiroNome": "<string>",
"sobrenome": "<string>",
"codPais": "<string>",
"telefone": "<string>",
"idRastreamento": "<string>",
"idTransacao": "<string>",
"endCobrancaRua": "<string>",
"endCobrancaCidade": "<string>",
"endCobrancaEstado": "<string>",
"endCobrancaCEP": "<string>",
"endCobrancaPais": "<string>",
"endEntregaRua": "<string>",
"endEntregaCidade": "<string>",
"endEntregaEstado": "<string>",
"endEntregaCEP": "<string>",
"endEntregaPais": "<string>",
"identificacaoDoCliente": "<string>",
"idDispositivo": "<string>",
"localizacaoDoServico": "<string>"
}
]
}'
Copy
Ask AI
{
"msg": "<string>",
"messages": [
{
"messageType": 1,
"code": "<string>",
"context": "<string>",
"description": "<string>",
"field": "<string>"
}
],
"hasError": true,
"falha": true,
"json": "<string>"
}
Assistente
Responses are generated using AI and may contain mistakes.