Esquemas de proteção da conta
Este artigo descreve o esquema por meio da API (interface de programação de aplicativo). Para obter mais informações, consulte Integrar APIs em tempo real do Dynamics 365 Fraud Protection.
AccountCreation
A API AccountCreation permite que você compartilhe informações e contexto com o Microsoft Dynamics 365 Fraud Protection sobre futuros eventos de criação de contas para avaliação de risco.
| Objeto | Atributo | Tipo | descrição |
|---|---|---|---|
| ID de locatário | cadeia de caracteres | TenantId é o GUID que representa o locatário do Azure Active Directory. | |
| Organização | cadeia de caracteres | O valor é AP.AccountCreation. | |
| Versão | cadeia de caracteres | O valor é 0,5. | |
| MetaData | trackingId | cadeia de caracteres | O identificador do evento AccountCreationId. |
| MetaData | SignupId | cadeia de caracteres | O identificador do evento AccountCreationId. (Esse valor pode coincidir com o valor do atributo trackingId, mas é diferente do atributo userId.) |
| MetaData | assessmentType | cadeia de caracteres | O tipo de avaliação do evento. Os valores possíveis são evaluate e protect. Se nenhum valor for especificado, o valor padrão será protect. |
| MetaData | customerLocalDate | dateTime | A data de criação do evento AccountCreationId, no fuso horário local do cliente. O formato é ISO 8601. |
| MetaData | merchantTimeStamp | dateTime | O carimbo de data/hora do evento. |
| DeviceContext | DeviceContextId | cadeia de caracteres | A ID da sessão do cliente. Essas informações são dominadas pelo DFP (Serviço de Análise de Impressões Digitais para Dispositivos). |
| DeviceContext | ipAddress | cadeia de caracteres | O endereço IP do cliente, conforme fornecido pelo comerciante. |
| DeviceContext | provedor | cadeia de caracteres | O provedor de informações do dispositivo. Os valores possíveis são DFPFingerprinting e Merchant. Se nenhum valor for especificado, o valor padrão será DFPFingerprinting. |
| DeviceContext | externalDeviceId | cadeia de caracteres | A ID de dispositivo do cliente, conforme fornecido e dominado pelo comerciante. |
| DeviceContext | externalDeviceType | cadeia de caracteres | O tipo de dispositivo do cliente, conforme fornecido e dominado pelo comerciante. Os valores possíveis são Mobile, Computer, MerchantHardware, Tablet e GameConsole. |
| Usuário | userId | cadeia de caracteres | O identificador de usuário. Essas informações são fornecidas pelo comerciante. |
| Usuário | userType | cadeia de caracteres | O tipo de perfil do usuário. Os valores possíveis são Consumer, Developer, Seller, Publisher e Tenant. |
| Usuário | UserName | cadeia de caracteres | O nome de usuário fornecido pelo usuário que é exclusivo no sistema do comerciante. |
| Usuário | firstName | cadeia de caracteres | O primeiro nome fornecido pelo usuário na conta. |
| Usuário | lastName | cadeia de caracteres | O último nome fornecido pelo usuário na conta. |
| Usuário | País/Região | cadeia de caracteres | O país ou região do usuário. O valor deve ser um código de país/região ISO de duas letras (por exemplo: BR). |
| Usuário | zipCode | cadeia de caracteres | O código postal do usuário. |
| Usuário | timeZone | cadeia de caracteres | O fuso horário do usuário. |
| Usuário | idioma | cadeia de caracteres | O idioma e território do usuário (por exemplo, EN-US). |
| Usuário | membershipId | cadeia de caracteres | A ID da associação, se o usuário já tiver uma associação existente com o comerciante. |
| Usuário | isMembershipIdUserName | bool | Um valor Verdadeiro/Falso que indica se o valor de membershipId pode ser usado como o nome de usuário. O valor padrão é Falso. |
| Telefone | phoneType | enumeração | O tipo de número de telefone. Os valores possíveis são Primary e Alternative. O valor padrão é Principal. |
| Telefone | phoneNumber | cadeia de caracteres | O telefone do usuário. O formato deve ser o código de país/região seguido de um hífen () e o número de telefone (por exemplo: para os EUA, +1-1234567890). |
| Telefone | isPhoneNumberValidated | bool | Um valor Verdadeiro/Falso que indica se o número de telefone fornecido pelo usuário foi verificado como de propriedade do usuário. |
| Telefone | phoneNumberValidatedDate | dateTime | A data de validação do número de telefone do usuário. O formato é ISO 8601. |
| Telefone | isPhoneUserName | bool | Um valor Verdadeiro/Falso que indica se o número de telefone pode ser usado como o nome de usuário. O valor padrão é Falso. |
| emailType | enumeração | O tipo de endereço de email. Os valores possíveis são Primary e Alternative. | |
| emailValue | cadeia de caracteres | O endereço de email do usuário. Esse valor não diferencia maiúsculas de minúsculas. | |
| isEmailValidated | bool | Um valor Verdadeiro/Falso que indica se o endereço de email fornecido pelo usuário foi verificado como de propriedade do usuário. | |
| emailValidatedDate | dateTime | A data de validação do endereço de email do usuário. O formato é ISO 8601. | |
| isEmailUserName | bool | Um valor Verdadeiro/Falso que indica se o endereço de email pode ser usado como o nome de usuário. O valor padrão é Falso. | |
| SSOAuthenticationProvider | authenticationProvider | cadeia de caracteres | O provedor de autenticação de logon único (SSO) do usuário, se for diferente do provedor de autenticação SSO do comerciante. Os valores possíveis são MSA, Facebook, PSN, MerchantAuth e Google. |
| SSOAuthenticationProvider | displayName | cadeia de caracteres | O nome de exibição do usuário para o provedor de autenticação SSO (por exemplo, o nome de usuário de uma conta da Microsoft, do Facebook ou do Google). |
| Endereço | addressType | enumeração | O tipo de endereço. Os valores possíveis são Primary, Billing, Shipping e Alternative. O valor padrão é Principal. |
| Endereço | firstName | cadeia de caracteres | O nome fornecido pelo usuário associado ao endereço. |
| Endereço | lastName | cadeia de caracteres | O sobrenome fornecido pelo usuário associado ao endereço. |
| Endereço | phoneNumber | cadeia de caracteres | O número de telefone fornecido pelo usuário associado ao endereço. |
| Endereço | street1 | cadeia de caracteres | A primeira linha fornecida para o endereço. |
| Endereço | street2 | cadeia de caracteres | A segunda linha fornecida para o endereço. (Esse valor pode ficar em branco.) |
| Endereço | street3 | cadeia de caracteres | A terceira linha fornecida para o endereço. (Esse valor pode ficar em branco.) |
| Endereço | cidade | cadeia de caracteres | A cidade fornecida para o endereço. |
| Endereço | estado | cadeia de caracteres | O estado ou província fornecido para o endereço. |
| Endereço | bairro | cadeia de caracteres | O bairro fornecido para o endereço. |
| Endereço | zipCode | cadeia de caracteres | O código fornecido para o endereço. |
| Endereço | País/Região | cadeia de caracteres | O código do país/região fornecido para o endereço. O valor deve ser um código de país/região ISO de duas letras (por exemplo: BR). |
| PaymentInstrument | merchantPaymentInstrumentId | cadeia de caracteres | O identificador do meio de pagamento. Essas informações são fornecidas pelo comerciante. |
| PaymentInstrument | tipo | enumeração | O tipo de pagamento. Os valores possíveis são CreditCard, DirectDebit, PayPal, MobileBilling, OnlineBankTransfer, Invoice, MerchantGiftCard, MerchantWallet, CashOnDelivery, Paytm e CCAvenue. |
| PaymentInstrument | creationDate | Data/Hora | A data da primeira entrada do meio de pagamento no sistema do comerciante. O formato é ISO 8601. |
| PaymentInstrument | updateDate | Data/Hora | A data da última atualização do meio de pagamento no sistema do comerciante. O formato é ISO 8601. |
| PaymentInstrument | estado | cadeia de caracteres | O estado atual do meio de pagamento no sistema do comerciante (por exemplo, Ativo, Bloqueadoou Expirado). |
| PaymentInstrument | cardType | cadeia de caracteres | Este atributo é usado somente para pagamentos do tipo CreditCard ou DirectDebit. Os valores possíveis são Visa, Mastercard, Amex, ACH, SEPA, UnionPay, Inicis, MobileBillingCarrier, Discover, AllPay, JCB e DiscoverDiners. |
| PaymentInstrument | holderName | cadeia de caracteres | O nome do usuário do meio de pagamento. Este atributo é usado somente para pagamentos do tipo CreditCard ou DirectDebit. |
| PaymentInstrument | compartimento | cadeia de caracteres | Este atributo é usado somente para pagamentos do tipo CreditCard ou DirectDebit. |
| PaymentInstrument | expirationDate | cadeia de caracteres | A data de vencimento do meio de pagamento no sistema do comerciante. O formato é ISO 8601. Este atributo é usado somente para pagamentos do tipo CreditCard ou DirectDebit. |
| PaymentInstrument | lastFourDigits | cadeia de caracteres | Este atributo é usado somente para pagamentos do tipo CreditCard ou DirectDebit. |
| PaymentInstrument | cadeia de caracteres | O endereço de email associado com o meio de pagamento. Este atributo é usado somente para pagamentos do tipo PayPal. | |
| PaymentInstrument | billingAgreementId | cadeia de caracteres | Este atributo é usado somente para pagamentos do tipo PayPal. |
| PaymentInstrument | payerId | cadeia de caracteres | Este atributo é usado somente para pagamentos do tipo PayPal. |
| PaymentInstrument | payerStatus | cadeia de caracteres | Um valor que indica se o PayPal verificou o pagador. Este atributo é usado somente para pagamentos do tipo PayPal. |
| PaymentInstrument | addressStatus | cadeia de caracteres | Um valor que indica se o PayPal verificou o endereço do pagador. Este atributo é usado somente para pagamentos do tipo PayPal. |
| PaymentInstrument | imei | cadeia de caracteres | Este atributo é usado somente para pagamentos do tipo MobileBilling. |
| PaymentInstrument \ BillingAddress | addressType | enumeração | O tipo de endereço. Os valores possíveis são Primary, Billing, Shipping e Alternative. Os valores possíveis são Billing. |
| PaymentInstrument \ BillingAddress | firstName | cadeia de caracteres | O nome fornecido pelo usuário associado ao endereço. |
| PaymentInstrument \ BillingAddress | lastName | cadeia de caracteres | O sobrenome fornecido pelo usuário associado ao endereço. |
| PaymentInstrument \ BillingAddress | phoneNumber | cadeia de caracteres | O número de telefone fornecido pelo usuário associado ao endereço. |
| PaymentInstrument \ BillingAddress | street1 | cadeia de caracteres | A primeira linha fornecida para o endereço. |
| PaymentInstrument \ BillingAddress | street2 | cadeia de caracteres | A segunda linha fornecida para o endereço. (Esse valor pode ficar em branco.) |
| PaymentInstrument \ BillingAddress | street3 | cadeia de caracteres | A terceira linha fornecida para o endereço. (Esse valor pode ficar em branco.) |
| PaymentInstrument \ BillingAddress | cidade | cadeia de caracteres | A cidade fornecida para o endereço. |
| PaymentInstrument \ BillingAddress | estado | cadeia de caracteres | O estado ou província fornecido para o endereço. |
| PaymentInstrument \ BillingAddress | bairro | cadeia de caracteres | O bairro fornecido para o endereço |
| PaymentInstrument \ BillingAddress | zipCode | cadeia de caracteres | O código fornecido para o endereço. |
| PaymentInstrument \ BillingAddress | País/Região | cadeia de caracteres | O código do país/região fornecido para o endereço. O valor deve ser um código de país/região ISO de duas letras (por exemplo: BR). |
| MarketingContext | campaignType | enumeração | O tipo de campanha de marketing. Os valores possíveis são Direct, Email, Referral, PaidSearch, OrganicSearch, Advertising, SocialNetwork, General Marketing, Unknown, Other. |
| MarketingContext | trafficSource-referrer | cadeia de caracteres | A origem deste usuário, se conhecido. Se a indicação foi feita pelo usuário existente, forneça o MerchantUserId original do indicador. |
| MarketingContext | trafficSource-referralLink | cadeia de caracteres | A origem deste usuário, se conhecido. Se a indicação foi feita por meio de outros tipos de campanha em vez da indicação do usuário existente, forneça o link da URL de origem. |
| MarketingContext | trafficSource-referralSite | cadeia de caracteres | O site de origem do tráfego. Os valores possíveis são Facebook, Instagram, Twitter, Bing, Google, Pinterest, WhatsApp, etc. |
| MarketingContext | IncentiveType | enumeração | O tipo de incentivo do novo usuário. Os valores possíveis são None, CashBack, Discount, FreeTrial, BonusPoints, Gift, Unknown, Other. |
| MarketingContext | incentiveOffer | cadeia de caracteres | O nome da oferta de incentivo exato. Por exemplos: R$ 5 de desconto na primeira ordem, remessa gratuita, 5.000 pontos. |
| MarketingContext | CampaignStartDate | data | A data da campanha que começa na coleção de incentivos. |
| MarketingContext | CampaignExpireDate | data | A data da campanha que expira na coleção de incentivos. |
| MarketingContext | IncentiveQuantityLimit | cadeia de caracteres | O limite da quantidade de incentivos definida pelo comerciante. Por exemplo, máximo de três 5.000 pontos por usuário por dia. |
AccountCreationStatus
A API AccountCreationStatus permite que você compartilhe informações e contexto com o Fraud Protection sobre o status de um evento de criação de conta. Este evento é somente um evento de ingestão de dados.
| Objeto | Atributo | Tipo | descrição |
|---|---|---|---|
| ID de locatário | cadeia de caracteres | TenantId é o GUID que representa o locatário do Azure Active Directory. | |
| Organização | cadeia de caracteres | O valor é AP.AccountCreation.Status. | |
| Versão | cadeia de caracteres | O valor é 0,5. | |
| MetaData | trackingID | cadeia de caracteres | O identificador do evento SignupStatus. |
| MetaData | signupid | cadeia de caracteres | O identificador do evento Inscrição. |
| MetaData | merchantTimeStamp | Data e Hora | O carimbo de data/hora do evento. |
| MetaData | userId | cadeia de caracteres | O identificador de usuário. Essas informações são fornecidas pelo comerciante. |
| StatusDetails | statusType | enumeração | O tipo de status: Aprovado, Rejeitado ou Pendente. |
| StatusDetails | reasonType | enumeração | O tipo de motivo: desafio abandonado, falha no desafio, desafio aprovado, desafio pendente, falha na revisão, análise aprovada, análise pendente ou Nenhum. O valor padrão é Nenhum. |
| StatusDetails | challengeType | enumeração | O tipo de status da análise: SMS, Email, Telefone, Outro ou Nenhum. O valor padrão é Nenhum. |
| StatusDetails | statusDate | Data/Hora | A data e a hora em que o status foi aplicado. O formato é ISO 8601. |
AccountLogIn
A API AccountLogIn permite que você compartilhe informações e contexto com o Fraud Protection sobre um futuro evento de logon para avaliação de risco.
| Objeto | Atributo | Tipo | Descrição |
|---|---|---|---|
| Nome | cadeia de caracteres | O valor é AP.AccountLogin. | |
| Versão | cadeia de caracteres | O valor é 0,5. | |
| MetaData | trackingId | cadeia de caracteres | O identificador do evento Logon. |
| MetaData | LogInId | cadeia de caracteres | O identificador do evento Inscrição. (Esse valor pode corresponder ao valor do atributo trackingId.) |
| MetaData | assessmentType | cadeia de caracteres | O tipo de avaliação do evento. Os valores possíveis são evaluate e protect. Se nenhum valor for especificado, o valor padrão será protect. |
| MetaData | customerLocalDate | dateTime | A data de criação do evento Inscrição, no fuso horário local do cliente. O formato é ISO 8601. |
| MetaData | merchantTimeStamp | dateTime | O carimbo de data/hora do evento. |
| DeviceContext | DeviceContextId | cadeia de caracteres | A ID da sessão do cliente. Essas informações são dominadas pelo DFP (Serviço de Análise de Impressões Digitais para Dispositivos). |
| DeviceContext | ipAddress | cadeia de caracteres | O endereço IP do cliente, conforme fornecido pelo comerciante. |
| DeviceContext | provedor | cadeia de caracteres | O provedor de informações do dispositivo. Os valores possíveis são DFPFingerprinting e Merchant. Se nenhum valor for especificado, o valor padrão será DFPFingerprinting. |
| DeviceContext | externalDeviceId | cadeia de caracteres | A ID de dispositivo do cliente, conforme fornecido e dominado pelo comerciante. |
| DeviceContext | externalDeviceType | cadeia de caracteres | O tipo de dispositivo do cliente, conforme fornecido e dominado pelo comerciante. |
| Usuário | userId | cadeia de caracteres | O identificador de usuário. Essas informações são fornecidas pelo comerciante. |
| Usuário | userType | cadeia de caracteres | O tipo de perfil do usuário. Os valores possíveis são Consumer, Developer, Seller, Publisher e Tenant. |
| Usuário | UserName | cadeia de caracteres | O nome de usuário fornecido pelo usuário que é exclusivo no sistema do comerciante. |
| SSOAuthenticationProvider | authenticationProvider | cadeia de caracteres | O provedor de autenticação SSO do usuário, se for diferente do provedor de autenticação SSO do comerciante. Os valores possíveis são MSA, Facebook, PSN, MerchantAuth e Google. |
| SSOAuthenticationProvider | displayName | cadeia de caracteres | O nome de exibição do usuário para o provedor de autenticação SSO. Por exemplo, o nome de usuário de uma conta Microsoft, do Facebook ou do Google. |
| RecentUpdate | lastPhoneNumberUpdate | dateTime | A data/hora da atualização mais recente ou da criação de qualquer número de telefone. |
| RecentUpdate | lastEmailUpdate | dateTime | A data/hora da atualização mais recente ou da criação de qualquer endereço de email. |
| RecentUpdate | lastAddressUpdate | dateTime | A data/hora da atualização mais recente ou da criação de qualquer endereço. |
| RecentUpdate | lastPaymentInstrumentUpdate | dateTime | A data/hora da atualização mais recente ou da criação de qualquer meio de pagamento. |
| MarketingContext | campaignType | enumeração | O tipo de campanha de marketing. Os valores possíveis são Direct, Email, Referral, PaidSearch, OrganicSearch, Advertising, SocialNetwork, General Marketing, Unknown, Other. |
| MarketingContext | trafficSource-referrer | cadeia de caracteres | A origem deste usuário, se conhecido. Se a indicação foi feita pelo usuário existente, forneça o MerchantUserId original do indicador. |
| MarketingContext | trafficSource-referralLink | cadeia de caracteres | A origem deste usuário, se conhecido. Se a indicação foi feita por meio de outros tipos de campanha em vez da indicação do usuário existente, forneça o link da URL de origem. |
| MarketingContext | trafficSource-referralSite | cadeia de caracteres | O site de origem do tráfego. Os valores possíveis são Facebook, Instagram, Twitter, Bing, Google, Pinterest, WhatsApp, etc. |
| MarketingContext | IncentiveType | enumeração | O tipo de incentivo do novo usuário. Os valores possíveis são None, CashBack, Discount, FreeTrial, BonusPoints, Gift, Unknown, Other. |
| MarketingContext | incentiveOffer | cadeia de caracteres | O nome da oferta de incentivo exato. Por exemplos: R$ 5 de desconto na primeira ordem, remessa gratuita, 5.000 pontos. |
| MarketingContext | CampaignStartDate | data | A data da campanha que começa na coleção de incentivos. |
| MarketingContext | CampaignExpireDate | data | A data da campanha que expira na coleção de incentivos. |
| MarketingContext | IncentiveQuantityLimit | cadeia de caracteres | O limite da quantidade de incentivos definida pelo comerciante. Por exemplo, máximo de três 5.000 pontos por usuário por dia. |
AccountLogInStatus
A API AccountLogInStatus permite que você compartilhe informações e contexto com o Fraud Protection sobre o status de um evento de logon de conta. Este evento é somente um evento de ingestão de dados.
| Objeto | Atributo | Tipo | Descrição |
|---|---|---|---|
| Nome | cadeia de caracteres | O valor é AP.AccountLogin.Status. | |
| Versão | cadeia de caracteres | O valor é 0,5. | |
| MetaData | trackingID | cadeia de caracteres | O identificador do evento LoginStatus. |
| MetaData | logInId | cadeia de caracteres | O identificador do evento Logon. |
| MetaData | merchantTimeStamp | Data e Hora | O carimbo de data/hora do evento. |
| MetaData | userId | cadeia de caracteres | O identificador de usuário. Essas informações são fornecidas pelo comerciante. |
| StatusDetails | statusType | cadeia de caracteres | O tipo de status: Aprovado, Rejeitado ou Pendente. |
| StatusDetails | reasonType | enumeração | O tipo de motivo: desafio abandonado, falha no desafio, desafio aprovado, desafio pendente, falha na revisão, análise aprovada, análise pendente ou Nenhum. O valor padrão é Nenhum. |
| StatusDetails | challengeType | enumeração | O tipo de status da análise: SMS, Email, Telefone, Outro ou Nenhum. O valor padrão é Nenhum. |
| StatusDetails | statusDate | Data/Hora | A data e a hora em que o status foi aplicado. O formato é ISO 8601. |
AccountUpdate
A API AccountUpdate permite que você compartilhe atualizações de informações da conta com o Fraud Protection. Por exemplo, as seguintes informações podem ser editadas ou adicionadas: perfil do usuário, endereço, meio de pagamento, número de telefone, endereço de email e SSO. Este evento é somente um evento de ingestão de dados.
| Objeto | Atributo | Tipo | Descrição |
|---|---|---|---|
| Nome | cadeia de caracteres | O valor é AP.AccountUpdate. | |
| Versão | cadeia de caracteres | O valor é 0,5. | |
| MetaData | trackingId | cadeia de caracteres | O identificador do evento AccountUpdate. |
| MetaData | SignupId | cadeia de caracteres | O identificador do evento AccountUpdateId. (Esse valor pode corresponder ao valor do atributo trackingId.) |
| MetaData | customerLocalDate | dateTime | A data de criação do evento AccountUpdate, no fuso horário local do cliente. O formato é ISO 8601. |
| MetaData | merchantTimeStamp | dateTime | O carimbo de data/hora do evento. |
| DeviceContext | DeviceContextId | cadeia de caracteres | A ID da sessão do cliente. Essas informações são dominadas pelo DFP (Serviço de Análise de Impressões Digitais para Dispositivos). |
| DeviceContext | ipAddress | cadeia de caracteres | O endereço IP do cliente, conforme fornecido pelo comerciante. |
| DeviceContext | provedor | cadeia de caracteres | O provedor de informações do dispositivo. Os valores possíveis são DFPFingerprinting e Merchant. Se nenhum valor for especificado, o valor padrão será DFPFingerprinting. |
| DeviceContext | externalDeviceId | cadeia de caracteres | A ID de dispositivo do cliente, conforme fornecido e dominado pelo comerciante. |
| DeviceContext | externalDeviceType | cadeia de caracteres | O tipo de dispositivo do cliente, conforme fornecido e dominado pelo comerciante. Os valores possíveis são Mobile', Computer, MerchantHardware, Tablet e GameConsole. |
| Usuário | userId | cadeia de caracteres | O identificador de usuário. Essas informações são fornecidas pelo comerciante. |
| Usuário | userType | cadeia de caracteres | O tipo de perfil do usuário. Os valores possíveis são Consumer, Developer, Seller, Publisher e Tenant. |
| Usuário | UserName | cadeia de caracteres | O nome de usuário fornecido pelo usuário que é exclusivo no sistema do comerciante. |
| Usuário | firstName | cadeia de caracteres | O primeiro nome fornecido pelo usuário na conta. |
| Usuário | lastName | cadeia de caracteres | O último nome fornecido pelo usuário na conta. |
| Usuário | País/Região | cadeia de caracteres | O país ou região do usuário. O valor deve ser um código de país/região ISO de duas letras (por exemplo: BR). |
| Usuário | zipCode | cadeia de caracteres | O código postal do usuário. |
| Usuário | timeZone | cadeia de caracteres | O fuso horário do usuário. |
| Usuário | idioma | cadeia de caracteres | O idioma e território do usuário (por exemplo, EN-US). |
| Usuário | membershipId | cadeia de caracteres | A ID da associação, se o usuário já tiver uma associação existente com o comerciante. |
| Usuário | isMembershipIdUserName | bool | Um valor Verdadeiro/Falso que indica se o valor de membershipId pode ser usado como o nome de usuário. O valor padrão é Falso. |
| Telefone | phoneType | enumeração | O tipo de número de telefone. Os valores possíveis são Primary e Alternative. O valor padrão é Principal. |
| Telefone | phoneNumber | cadeia de caracteres | O telefone do usuário. O formato deve ser o código de país/região seguido de um hífen () e o número de telefone (por exemplo: para os EUA, +1-1234567890). |
| Telefone | isPhoneNumberValidated | bool | Um valor Verdadeiro/Falso que indica se o número de telefone fornecido pelo usuário foi verificado como de propriedade do usuário. |
| Telefone | phoneNumberValidatedDate | dateTime | A data de validação do número de telefone do usuário. O formato é ISO 8601. |
| Telefone | isPhoneUserName | bool | Um valor Verdadeiro/Falso que indica se o número de telefone pode ser usado como o nome de usuário. O valor padrão é Falso. |
| emailType | enumeração | O tipo de endereço de email. Os valores possíveis são Primary e Alternative. | |
| emailValue | cadeia de caracteres | O endereço de email do usuário. Esse valor não diferencia maiúsculas de minúsculas. | |
| isEmailValidated | bool | Um valor Verdadeiro/Falso que indica se o endereço de email fornecido pelo usuário foi verificado como de propriedade do usuário. | |
| emailValidatedDate | dateTime | A data de validação do endereço de email do usuário. O formato é ISO 8601. | |
| isEmailUserName | bool | Um valor Verdadeiro/Falso que indica se o endereço de email pode ser usado como o nome de usuário. O valor padrão é Falso. | |
| SSOAuthenticationProvider | authenticationProvider | cadeia de caracteres | O provedor de autenticação SSO do usuário, se for diferente do provedor de autenticação SSO do comerciante. Os valores possíveis são MSA, Facebook, PSN, MerchantAuth e Google. |
| SSOAuthenticationProvider | displayName | cadeia de caracteres | O nome de exibição do usuário para o provedor de autenticação SSO (por exemplo, o nome de usuário de uma conta da Microsoft, do Facebook ou do Google). |
| Endereço | addressType | enumeração | O tipo de endereço. Os valores possíveis são Primary, Billing, Shipping e Alternative. O valor padrão é Principal. |
| Endereço | firstName | cadeia de caracteres | O nome fornecido pelo usuário associado ao endereço. |
| Endereço | lastName | cadeia de caracteres | O sobrenome fornecido pelo usuário associado ao endereço. |
| Endereço | phoneNumber | cadeia de caracteres | O número de telefone fornecido pelo usuário associado ao endereço. |
| Endereço | street1 | cadeia de caracteres | A primeira linha fornecida para o endereço. |
| Endereço | street2 | cadeia de caracteres | A segunda linha fornecida para o endereço. (Esse valor pode ficar em branco.) |
| Endereço | street3 | cadeia de caracteres | A terceira linha fornecida para o endereço. (Esse valor pode ficar em branco.) |
| Endereço | cidade | cadeia de caracteres | A cidade fornecida para o endereço. |
| Endereço | estado | cadeia de caracteres | O estado ou província fornecido para o endereço. |
| Endereço | bairro | cadeia de caracteres | O bairro fornecido para o endereço. |
| Endereço | zipCode | cadeia de caracteres | O código fornecido para o endereço. |
| Endereço | País/Região | cadeia de caracteres | O código do país/região fornecido para o endereço. O valor deve ser um código de país/região ISO de duas letras (por exemplo: BR). |
| PaymentInstrument | merchantPaymentInstrumentId | cadeia de caracteres | O identificador do meio de pagamento. Essas informações são fornecidas pelo comerciante. |
| PaymentInstrument | tipo | enumeração | O tipo de pagamento. Os valores possíveis são CreditCard, DirectDebit, PayPal, MobileBilling, OnlineBankTransfer, Invoice, MerchantGiftCard, MerchantWallet, CashOnDelivery, Paytm e CCAvenue. |
| PaymentInstrument | creationDate | Data/Hora | A data da primeira entrada do meio de pagamento no sistema do comerciante. O formato é ISO 8601. |
| PaymentInstrument | updateDate | Data/Hora | A data da última atualização do meio de pagamento no sistema do comerciante. O formato é ISO 8601. |
| PaymentInstrument | estado | cadeia de caracteres | O estado atual do meio de pagamento no sistema do comerciante (por exemplo, Ativo, Bloqueadoou Expirado). |
| PaymentInstrument | cardType | cadeia de caracteres | Este atributo é usado somente para pagamentos do tipo CreditCard ou DirectDebit. Os valores possíveis são Visa, Mastercard, Amex, ACH, SEPA, UnionPay, Inicis, MobileBillingCarrier, Discover, AllPay, JCB e DiscoverDiners. |
| PaymentInstrument | holderName | cadeia de caracteres | O nome do usuário do meio de pagamento. Esse atributo é usado somente para pagamentos dos tipos CreditCard DirectDebit. |
| PaymentInstrument | compartimento | cadeia de caracteres | Este atributo é usado somente para pagamentos do tipo CreditCard ou DirectDebit. |
| PaymentInstrument | expirationDate | cadeia de caracteres | A data de vencimento do meio de pagamento no sistema do comerciante. O formato é ISO 8601. Este atributo é usado somente para pagamentos do tipo CreditCard ou DirectDebit. |
| PaymentInstrument | lastFourDigits | cadeia de caracteres | Este atributo é usado somente para pagamentos do tipo CreditCard ou DirectDebit. |
| PaymentInstrument | cadeia de caracteres | O endereço de email associado com o meio de pagamento. Este atributo é usado somente para pagamentos do tipo PayPal. | |
| PaymentInstrument | billingAgreementId | cadeia de caracteres | Este atributo é usado somente para pagamentos do tipo PayPal. |
| PaymentInstrument | payerId | cadeia de caracteres | Este atributo é usado somente para pagamentos do tipo PayPal. |
| PaymentInstrument | payerStatus | cadeia de caracteres | Um valor que indica se o PayPal verificou o pagador. Este atributo é usado somente para pagamentos do tipo PayPal. |
| PaymentInstrument | addressStatus | cadeia de caracteres | Um valor que indica se o PayPal verificou o endereço do pagador. Este atributo é usado somente para pagamentos do tipo PayPal. |
| PaymentInstrument | imei | cadeia de caracteres | Este atributo é usado somente para pagamentos do tipo MobileBilling. |
| PaymentInstrument \ BillingAddress | addressType | enumeração | O tipo de endereço. Os valores possíveis são Primary, Billing, Shipping e Alternative. Os valores possíveis são Billing. |
| PaymentInstrument \ BillingAddress | firstName | cadeia de caracteres | O nome fornecido pelo usuário associado ao endereço. |
| PaymentInstrument \ BillingAddress | lastName | cadeia de caracteres | O sobrenome fornecido pelo usuário associado ao endereço. |
| PaymentInstrument \ BillingAddress | phoneNumber | cadeia de caracteres | O número de telefone fornecido pelo usuário associado ao endereço. |
| PaymentInstrument \ BillingAddress | street1 | cadeia de caracteres | A primeira linha fornecida para o endereço. |
| PaymentInstrument \ BillingAddress | street2 | cadeia de caracteres | A segunda linha fornecida para o endereço. (Esse valor pode ficar em branco.) |
| PaymentInstrument \ BillingAddress | street3 | cadeia de caracteres | A terceira linha fornecida para o endereço. (Esse valor pode ficar em branco.) |
| PaymentInstrument \ BillingAddress | cidade | cadeia de caracteres | A cidade fornecida para o endereço. |
| PaymentInstrument \ BillingAddress | estado | cadeia de caracteres | O estado ou província fornecido para o endereço. |
| PaymentInstrument \ BillingAddress | bairro | cadeia de caracteres | O bairro fornecido para o endereço. |
| PaymentInstrument \ BillingAddress | zipCode | cadeia de caracteres | O código fornecido para o endereço. |
| PaymentInstrument \ BillingAddress | País/Região | cadeia de caracteres | O código do país/região fornecido para o endereço. O valor deve ser um código de país/região ISO de duas letras (por exemplo: BR). |
Etiquetas
A API de rótulos permite que você compartilhe informações adicionais sobre os resultados de transações e eventos para o treinamento do modelo que é baseado em um conjunto adicional de sinais de fraude. Essas informações incluem informações que você recebe de bancos. Este evento é somente um evento de ingestão de dados.
| Categoria | Atributo | Tipo | Descrição |
|---|---|---|---|
| Nome | cadeia de caracteres | O valor é AP.AccountLabel. | |
| Versão | cadeia de caracteres | O valor é 0,5. | |
| MetaData | TrackingId | Sequência de caracteres | A ID exclusiva para cada evento/registro. |
| MetaData | merchantTimeStamp | Data e Hora | A data, no fuso horário do comerciante. O formato é ISO 8601. |
| MetaData | userId | cadeia de caracteres | O identificador de usuário. Essas informações são fornecidas pelo comerciante. |
| Etiqueta | EventTimeStamp | Data e Hora | A data e a hora do evento. Os valores possíveis são: data do estorno ou data da análise. O formato é ISO 8601. |
| Etiqueta | LabelObjectType | enumeração | O tipo de rótulo: Compra, Criação de Conta, Logon da Conta, Atualização da Conta, Avaliação de Fraude Personalizada, Conta, Meio de Pagamento ou Email. |
| Etiqueta | LabelObjectId | Sequência de caracteres | O campo identificador para o objeto PurchaseId, AccountCreationId, AccountLoginId, AccountUpdateId, UserId, MerchantPaymentInstrumentId ou Email. |
| Etiqueta | LabelSource | enumeração | A origem do rótulo: Escalonamento do Cliente, Estorno, TC40_SAFE, Análise Manual, Reembolso, Análise Offline ou Análise de Proteção da Conta. |
| Etiqueta | LabelState | enumeração | O status atual do rótulo: Consulta Aceita, Fraude, Contestado, Revertido, Abuso, Solicitação Reenviada, AccountCompromised ou AccountNotCompromised. |
| Etiqueta | LabelReasonCodes | enumeração | Os códigos de motivo que estão associados a cada tipo de rótulo: Código de Resposta do Processador/Banco, Reembolso de Fraude, Tomada de Conta, Fraude de Meio de Pagamento, Fraude de Conta, Abuso, Fraude Amigável, Credenciais da Conta Vazadas ou Verificações de Proteção da Conta Aprovadas. |
| Etiqueta | Processador | Sequência de caracteres | O nome do banco ou do processador de pagamento que gera o TC40 ou o sistema para evitar fraudes de forma efetiva (SEGURA). |
| Etiqueta | EffectiveStartDate | Data e Hora | A data em que este rótulo entra em vigor. O formato é ISO 8601. |
| Etiqueta | EffectiveEndDate | Data e Hora | A data final desse rótulo. O formato é ISO 8601. |