Esquemas de proteção de conta
Este artigo descreve o esquema por meio da interface de programação de aplicativos (API). Para obter mais informações, consulte Integrar APIs em tempo real do Dynamics 365 Fraud Protection.
Criação de Conta
A API AccountCreation permite compartilhar informações e contexto com a Proteção contra Fraude do Microsoft Dynamics 365 sobre novos eventos de criação de conta para avaliação de risco.
| Object | Atributo | Tipo | Description |
|---|---|---|---|
| ID de Inquilino do | string | TenantId é o GUID que representa o Locatário do Azure ActiveDirectory. | |
| Nome | string | O valor é AP. Criação de contas. | |
| Versão | string | O valor é 0,5. | |
| Metadados | trackingId | string | O identificador do evento AccountCreationId . |
| Metadados | CadastroId | string | O identificador do evento AccountCreationId . (Esse valor pode corresponder ao valor do atributo trackingId , mas é diferente do atributo userId .) |
| Metadados | tipo de avaliação | string | O tipo de avaliação para o evento. Os valores possíveis são avaliados e protegidos. Se nenhum valor for especificado, o valor padrão será protect. |
| Metadados | customerLocalDate | dateTime | A data de criação do evento AccountCreationId , no fuso horário local do cliente. O formato é ISO 8601. |
| Metadados | merchantTimeStamp | dateTime | O carimbo de data/hora do evento. |
| DeviceContext | DeviceContextId | string | O ID da sessão do cliente. Essas informações são dominadas pelo DFP Device Fingerprinting Service. |
| DeviceContext | Endereço IP | string | O endereço IP do cliente, conforme fornecido pelo comerciante. |
| DeviceContext | fornecedor | string | 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 | string | O ID do dispositivo do cliente, conforme fornecido e controlado pelo comerciante. |
| DeviceContext | externalDeviceType | string | O tipo de dispositivo do cliente, conforme fornecido e dominado pelo comerciante. Os valores possíveis são Mobile, Computer, MerchantHardware, Tablet e GameConsole. |
| User | ID de Utilizador | string | O identificador do usuário. Estas informações são fornecidas pelo comerciante. |
| User | userType | string | O tipo de perfil do usuário. Os valores possíveis são Consumidor, Desenvolvedor, Vendedor, Editor e Locatário. |
| User | Nome de utilizador | string | O nome de usuário fornecido pelo usuário que é exclusivo no sistema do comerciante. |
| User | nomePróprio | string | O primeiro nome fornecido pelo usuário na conta. |
| User | apelido | string | O sobrenome fornecido pelo usuário na conta. |
| User | CountryRegion | string | O país ou região do utilizador. O valor deve ser um código ISO de país/região de duas letras (por exemplo, EUA). |
| User | CEP | string | O código postal do utilizador. |
| User | timeZone | string | O fuso horário do usuário. |
| User | idioma | string | O idioma e o território do utilizador (por exemplo, EN-US). |
| User | membershipId | string | O ID de associação, se o utilizador já tiver uma associação existente com o comerciante. |
| User | isMembershipIdUserName | booleano | Um valor True/False que indica se o valor membershipId pode ser usado como o nome de usuário. O valor padrão é False. |
| Telemóvel | phoneType | enumeração | O tipo de número de telefone. Os valores possíveis são Primário e Alternativo. O valor padrão é Primário. |
| Telemóvel | phoneNumber | string | O número de telefone do usuário. O formato deve ser o código do país/região seguido de um hífen (-) e, em seguida, o número de telefone (por exemplo, para os EUA, +1-1234567890). |
| Telemóvel | isPhoneNumberValidated | booleano | Um valor True/False que indica se o número de telefone fornecido pelo usuário foi verificado como de propriedade do usuário. |
| Telemóvel | telefoneNúmeroData Validada | dateTime | A data de validação do número de telefone do usuário. O formato é ISO 8601. |
| Telemóvel | isPhoneUserName | booleano | Um valor True/False que indica se o número de telefone pode ser usado como o nome de usuário. O valor padrão é False. |
| Tipo de email | enumeração | O tipo de endereço de e-mail. Os valores possíveis são Primário e Alternativo. | |
| emailValue | string | O endereço de correio eletrónico do utilizador. Esse valor não diferencia maiúsculas de minúsculas. | |
| isEmailValidated | booleano | Um valor True/False que indica se o endereço de e-mail fornecido pelo usuário foi verificado como de propriedade do usuário. | |
| emailData Validada | dateTime | A data de validação do endereço de e-mail do usuário. O formato é ISO 8601. | |
| isEmailUserName | booleano | Um valor True/False que indica se o endereço de e-mail pode ser usado como o nome de usuário. O valor padrão é False. | |
| SSOAuthenticationProvider | authenticationProvider | string | O fornecedor de autenticação de início de sessão único (SSO) do utilizador, se for diferente do fornecedor de autenticação de SSO do comerciante. Os valores possíveis são MSA, Facebook, PSN, MerchantAuth e Google. |
| SSOAuthenticationProvider | displayName | string | 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, Facebook ou Google). |
| Endereço | addressType | enumeração | O tipo de endereço. Os valores possíveis são Principal, Faturamento, Frete e Alternativo. O valor padrão é Primário. |
| Endereço | nomePróprio | string | O nome fornecido pelo usuário que está associado ao endereço. |
| Endereço | apelido | string | O sobrenome fornecido pelo usuário que está associado ao endereço. |
| Endereço | phoneNumber | string | O número de telefone fornecido pelo usuário que está associado ao endereço. |
| Endereço | rua1 | string | A primeira linha que foi fornecida para o endereço. |
| Endereço | rua2 | string | A segunda linha que foi fornecida para o endereço. (Este valor pode estar em branco.) |
| Endereço | rua3 | string | A terceira linha que foi fornecida para o endereço. (Este valor pode estar em branco.) |
| Endereço | cidade | string | A cidade que foi fornecida para o endereço. |
| Endereço | state | string | O estado ou província que foi fornecido para o endereço. |
| Endereço | Distrito | string | O distrito que foi fornecido para o endereço. |
| Endereço | CEP | string | O código postal que foi fornecido para o endereço. |
| Endereço | CountryRegion | string | O código de país/região fornecido para o endereço. O valor deve ser um código ISO de país/região de duas letras (por exemplo, EUA). |
| PaymentInstrument | merchantPaymentInstrumentId | string | O identificador do instrumento de pagamento. Estas 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 | criaçãoData de criação | DateTime | A data da primeira entrada do instrumento de pagamento no sistema do comerciante. O formato é ISO 8601. |
| PaymentInstrument | updateDate | DateTime | A data da última atualização do instrumento de pagamento no sistema do comerciante. O formato é ISO 8601. |
| PaymentInstrument | state | string | O estado atual do instrumento de pagamento no sistema do comerciante (por exemplo, Ativo, Bloqueado ou Expirado). |
| PaymentInstrument | tipo de cartão | string | Este atributo é usado apenas para pagamentos dos tipos CreditCard ou DirectDebit . Os valores possíveis são Visa, Mastercard, Amex, ACH, SEPA, UnionPay, Inicis, MobileBillingCarrier, Discover, AllPay, JCB e DiscoverDiners. |
| PaymentInstrument | holderName [en] | string | O nome do utilizador do instrumento de pagamento. Este atributo é usado apenas para pagamentos dos tipos CreditCard ou DirectDebit . |
| PaymentInstrument | classe | string | Este atributo é usado apenas para pagamentos dos tipos CreditCard ou DirectDebit . |
| PaymentInstrument | Data de expiração | string | A data de expiração do instrumento de pagamento no sistema do comerciante. O formato é ISO 8601. Este atributo é usado apenas para pagamentos dos tipos CreditCard ou DirectDebit . |
| PaymentInstrument | últimoQuatroDígitos | string | Este atributo é usado apenas para pagamentos dos tipos CreditCard ou DirectDebit . |
| PaymentInstrument | Correio eletrónico | string | O endereço de e-mail associado ao instrumento de pagamento. Este atributo é usado apenas para pagamentos do tipo PayPal . |
| PaymentInstrument | billingAgreementId | string | Este atributo é usado apenas para pagamentos do tipo PayPal . |
| PaymentInstrument | payerId | string | Este atributo é usado apenas para pagamentos do tipo PayPal . |
| PaymentInstrument | pagadorStatus | string | Um valor que indica se PayPal verificou o ordenante. Este atributo é usado apenas para pagamentos do tipo PayPal . |
| PaymentInstrument | endereçoStatus | string | Um valor que indica se PayPal verificou o endereço do ordenante. Este atributo é usado apenas para pagamentos do tipo PayPal . |
| PaymentInstrument | IMEI | string | Este atributo é usado apenas para pagamentos do tipo MobileBilling . |
| PaymentInstrument \ Endereço de Faturação | addressType | enumeração | O tipo de endereço. Os valores possíveis são Principal, Faturamento, Frete e Alternativo. O valor padrão é Faturamento. |
| PaymentInstrument \ Endereço de Faturação | nomePróprio | string | O nome fornecido pelo usuário que está associado ao endereço. |
| PaymentInstrument \ Endereço de Faturação | apelido | string | O sobrenome fornecido pelo usuário que está associado ao endereço. |
| PaymentInstrument \ Endereço de Faturação | phoneNumber | string | O número de telefone fornecido pelo usuário que está associado ao endereço. |
| PaymentInstrument \ Endereço de Faturação | rua1 | string | A primeira linha que foi fornecida para o endereço. |
| PaymentInstrument \ Endereço de Faturação | rua2 | string | A segunda linha que foi fornecida para o endereço. (Este valor pode estar em branco.) |
| PaymentInstrument \ Endereço de Faturação | rua3 | string | A terceira linha que foi fornecida para o endereço. (Este valor pode estar em branco.) |
| PaymentInstrument \ Endereço de Faturação | cidade | string | A cidade que foi fornecida para o endereço. |
| PaymentInstrument \ Endereço de Faturação | state | string | O estado ou província que foi fornecido para o endereço. |
| PaymentInstrument \ Endereço de Faturação | Distrito | string | O distrito que foi fornecido para o endereço |
| PaymentInstrument \ Endereço de Faturação | CEP | string | O código postal que foi fornecido para o endereço. |
| PaymentInstrument \ Endereço de Faturação | CountryRegion | string | O código de país/região fornecido para o endereço. O valor deve ser um código ISO de país/região de duas letras (por exemplo, EUA). |
| MarketingContexto | tipo de campanha | 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. |
| MarketingContexto | trafficSource-referenciador | string | A origem deste utilizador, se conhecida. Se for por indicação de usuário existente, forneça o MerchantUserId original do referenciador. |
| MarketingContexto | trafficSource-referralLink | string | A origem deste utilizador, se conhecida. Se for através de outros tipos de campanha em vez da referência de utilizador existente, forneça o link do URL de origem. |
| MarketingContexto | trafficSource-referralSite | string | O site de origem do tráfego. Os valores possíveis são Facebook, Instagram, Twitter, Bing, Google, Pinterest, WhatsApp, etc. |
| MarketingContexto | Tipo de Incentivo | enumeração | O tipo de incentivo para o novo usuário. Os valores possíveis são Nenhum, CashBack, Desconto, FreeTrial, BonusPoints, Gift, Desconhecido, Outros. |
| MarketingContexto | incentivoOferta | string | O nome exato da oferta de incentivo. Por exemplo, $5 de desconto na primeira encomenda, frete grátis, 5000 pontos. |
| MarketingContexto | CampaignStartDate | data | A data do início da campanha na recolha de incentivos. |
| MarketingContexto | CampaignExpireDate | data | A data de vencimento da campanha na cobrança de incentivos. |
| MarketingContexto | IncentiveQuantityLimit | string | O limite de quantidade de incentivo definido pelo comerciante. Por exemplo, máximo de três 5000 pontos por utilizador por dia. |
AccountCreationStatus
A API AccountCreationStatus permite compartilhar informações e contexto com a Proteção contra fraude sobre o status de um evento de criação de conta. Este evento é apenas um evento de ingestão de dados.
| Object | Atributo | Tipo | Description |
|---|---|---|---|
| ID de Inquilino do | string | TenantId é o GUID que representa o Locatário do Azure ActiveDirectory. | |
| Nome | string | O valor é AP. AccountCreation.Status. | |
| Versão | string | O valor é 0,5. | |
| Metadados | trackingID | string | O identificador do evento SignupStatus . |
| Metadados | cadastroId | string | O identificador do evento Signup . |
| Metadados | merchantTimeStamp | DateTime | O carimbo de data/hora do evento. |
| Metadados | ID de Utilizador | string | O identificador do usuário. Estas informações são fornecidas pelo comerciante. |
| StatusDetalhes | statusType | enumeração | O tipo de status: Aprovado, Rejeitado ou Pendente. |
| StatusDetalhes | reasonType | enumeração | O tipo de motivo: desafio abandonado, desafio falhado, desafio aprovado, desafio pendente, revisão falhada, revisão aprovada, revisão pendente ou nenhuma. O valor predefinido é None. |
| StatusDetalhes | challengeType | enumeração | O tipo de status da revisão: SMS, e-mail, telefone, outro ou nenhum. O valor predefinido é None. |
| StatusDetalhes | statusData | DateTime | A data e a hora em que o status foi aplicado. O formato é ISO 8601. |
ContaLogIn
A API AccountLogIn permite compartilhar informações e contexto com a Proteção contra Fraude sobre um evento de entrada para avaliação de risco.
| Object | Atributo | Tipo | Description |
|---|---|---|---|
| Name | string | O valor é AP. AccountLogin. | |
| Versão | string | O valor é 0,5. | |
| Metadados | trackingId | string | O identificador do evento Login . |
| Metadados | LogInId | string | O identificador do evento Signup . (Esse valor pode corresponder ao valor do atributo trackingId .) |
| Metadados | tipo de avaliação | string | O tipo de avaliação para o evento. Os valores possíveis são avaliados e protegidos. Se nenhum valor for especificado, o valor padrão será protect. |
| Metadados | customerLocalDate | dateTime | A data de criação do evento Signup , no fuso horário local do cliente. O formato é ISO 8601. |
| Metadados | merchantTimeStamp | dateTime | O carimbo de data/hora do evento. |
| DeviceContext | DeviceContextId | string | O ID da sessão do cliente. Essas informações são dominadas pelo DFP Device Fingerprinting Service. |
| DeviceContext | Endereço IP | string | O endereço IP do cliente, conforme fornecido pelo comerciante. |
| DeviceContext | fornecedor | string | 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 | string | O ID do dispositivo do cliente, conforme fornecido e controlado pelo comerciante. |
| DeviceContext | externalDeviceType | string | O tipo de dispositivo do cliente, conforme fornecido e dominado pelo comerciante. |
| User | ID de Utilizador | string | O identificador do usuário. Estas informações são fornecidas pelo comerciante. |
| User | userType | string | O tipo de perfil do usuário. Os valores possíveis são Consumidor, Desenvolvedor, Vendedor, Editor e Locatário. |
| User | Nome de utilizador | string | O nome de usuário fornecido pelo usuário que é exclusivo no sistema do comerciante. |
| SSOAuthenticationProvider | authenticationProvider | string | 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 | string | 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, Facebook ou Google. |
| Atualização recente | lastPhoneNumberUpdate | dateTime | A data/hora da atualização mais recente ou da criação de qualquer número de telefone. |
| Atualização recente | lastEmailUpdate | dateTime | A data/hora da atualização mais recente ou da criação de qualquer endereço de e-mail. |
| Atualização recente | lastAddressUpdate | dateTime | A data/hora da atualização mais recente ou da criação de qualquer endereço. |
| Atualização recente | lastPaymentInstrumentUpdate | dateTime | Data/hora da atualização ou criação mais recente de qualquer instrumento de pagamento. |
| MarketingContexto | tipo de campanha | 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. |
| MarketingContexto | trafficSource-referenciador | string | A origem deste utilizador, se conhecida. Se for por indicação de usuário existente, forneça o MerchantUserId original do referenciador. |
| MarketingContexto | trafficSource-referralLink | string | A origem deste utilizador, se conhecida. Se for através de outros tipos de campanha em vez da referência de utilizador existente, forneça o link do URL de origem. |
| MarketingContexto | trafficSource-referralSite | string | O site de origem do tráfego. Os valores possíveis são Facebook, Instagram, Twitter, Bing, Google, Pinterest, WhatsApp, etc. |
| MarketingContexto | Tipo de Incentivo | enumeração | O tipo de incentivo para o novo usuário. Os valores possíveis são Nenhum, CashBack, Desconto, FreeTrial, BonusPoints, Gift, Desconhecido, Outros. |
| MarketingContexto | incentivoOferta | string | O nome exato da oferta de incentivo. Por exemplo, $5 de desconto na primeira encomenda, frete grátis, 5000 pontos. |
| MarketingContexto | CampaignStartDate | data | A data do início da campanha na recolha de incentivos. |
| MarketingContexto | CampaignExpireDate | data | A data de vencimento da campanha na cobrança de incentivos. |
| MarketingContexto | IncentiveQuantityLimit | string | O limite de quantidade de incentivo definido pelo comerciante. Por exemplo, máximo de três 5000 pontos por utilizador por dia. |
AccountLogInStatus
A API AccountLogInStatus permite compartilhar informações e contexto com a Proteção contra fraude sobre o status de um evento de entrada na conta. Este evento é apenas um evento de ingestão de dados.
| Object | Atributo | Tipo | Description |
|---|---|---|---|
| Name | string | O valor é AP. AccountLogin.Status. | |
| Versão | string | O valor é 0,5. | |
| Metadados | trackingID | string | O identificador do evento LoginStatus . |
| Metadados | logInId | string | O identificador do evento Login . |
| Metadados | merchantTimeStamp | DateTime | O carimbo de data/hora do evento. |
| Metadados | ID de Utilizador | string | O identificador do usuário. Estas informações são fornecidas pelo comerciante. |
| StatusDetalhes | statusType | string | O tipo de status: Aprovado, Rejeitado ou Pendente. |
| StatusDetalhes | reasonType | enumeração | O tipo de motivo: desafio abandonado, desafio falhado, desafio aprovado, desafio pendente, revisão falhada, revisão aprovada, revisão pendente ou nenhuma. O valor predefinido é None. |
| StatusDetalhes | challengeType | enumeração | O tipo de status da revisão: SMS, e-mail, telefone, outro ou nenhum. O valor predefinido é None. |
| StatusDetalhes | statusData | DateTime | A data e a hora em que o status foi aplicado. O formato é ISO 8601. |
Atualizar Conta
A API AccountUpdate permite-lhe partilhar atualizações de informações da conta com a Proteção contra Fraudes. Por exemplo, as seguintes informações podem ser editadas ou adicionadas: perfil de usuário, endereço, instrumento de pagamento, número de telefone, endereço de e-mail e SSO. Este evento é apenas um evento de ingestão de dados.
| Object | Atributo | Tipo | Description |
|---|---|---|---|
| Name | string | O valor é AP. AccountUpdate. | |
| Versão | string | O valor é 0,5. | |
| Metadados | trackingId | string | O identificador do evento AccountUpdate . |
| Metadados | CadastroId | string | O identificador do evento AccountUpdateId . (Esse valor pode corresponder ao valor do atributo trackingId .) |
| Metadados | customerLocalDate | dateTime | A data de criação do evento AccountUpdate , no fuso horário local do cliente. O formato é ISO 8601. |
| Metadados | merchantTimeStamp | dateTime | O carimbo de data/hora do evento. |
| DeviceContext | DeviceContextId | string | O ID da sessão do cliente. Essas informações são dominadas pelo DFP Device Fingerprinting Service. |
| DeviceContext | Endereço IP | string | O endereço IP do cliente, conforme fornecido pelo comerciante. |
| DeviceContext | fornecedor | string | 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 | string | O ID do dispositivo do cliente, conforme fornecido e controlado pelo comerciante. |
| DeviceContext | externalDeviceType | string | O tipo de dispositivo do cliente, conforme fornecido e dominado pelo comerciante. Os valores possíveis são Mobile', Computer, MerchantHardware, Tablet e GameConsole. |
| User | ID de Utilizador | string | O identificador do usuário. Estas informações são fornecidas pelo comerciante. |
| User | userType | string | O tipo de perfil do usuário. Os valores possíveis são Consumidor, Desenvolvedor, Vendedor, Editor e Locatário. |
| User | Nome de utilizador | string | O nome de usuário fornecido pelo usuário que é exclusivo no sistema do comerciante. |
| User | nomePróprio | string | O primeiro nome fornecido pelo usuário na conta. |
| User | apelido | string | O sobrenome fornecido pelo usuário na conta. |
| User | CountryRegion | string | O país ou região do utilizador. O valor deve ser um código ISO de país/região de duas letras (por exemplo, EUA). |
| User | CEP | string | O código postal do utilizador. |
| User | timeZone | string | O fuso horário do usuário. |
| User | idioma | string | O idioma e o território do utilizador (por exemplo, EN-US). |
| User | membershipId | string | O ID de associação, se o utilizador já tiver uma associação existente com o comerciante. |
| User | isMembershipIdUserName | booleano | Um valor True/False que indica se o valor membershipId pode ser usado como o nome de usuário. O valor padrão é False. |
| Telemóvel | phoneType | enumeração | O tipo de número de telefone. Os valores possíveis são Primário e Alternativo. O valor padrão é Primário. |
| Telemóvel | phoneNumber | string | O número de telefone do usuário. O formato deve ser o código do país/região seguido de um hífen (-) e, em seguida, o número de telefone (por exemplo, para os EUA, +1-1234567890). |
| Telemóvel | isPhoneNumberValidated | booleano | Um valor True/False que indica se o número de telefone fornecido pelo usuário foi verificado como de propriedade do usuário. |
| Telemóvel | telefoneNúmeroData Validada | dateTime | A data de validação do número de telefone do usuário. O formato é ISO 8601. |
| Telemóvel | isPhoneUserName | booleano | Um valor True/False que indica se o número de telefone pode ser usado como o nome de usuário. O valor padrão é False. |
| Tipo de email | enumeração | O tipo de endereço de e-mail. Os valores possíveis são Primário e Alternativo. | |
| emailValue | string | O endereço de correio eletrónico do utilizador. Esse valor não diferencia maiúsculas de minúsculas. | |
| isEmailValidated | booleano | Um valor True/False que indica se o endereço de e-mail fornecido pelo usuário foi verificado como de propriedade do usuário. | |
| emailData Validada | dateTime | A data de validação do endereço de e-mail do usuário. O formato é ISO 8601. | |
| isEmailUserName | booleano | Um valor True/False que indica se o endereço de e-mail pode ser usado como o nome de usuário. O valor padrão é False. | |
| SSOAuthenticationProvider | authenticationProvider | string | 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 | string | 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, Facebook ou Google). |
| Endereço | addressType | enumeração | O tipo de endereço. Os valores possíveis são Principal, Faturamento, Frete e Alternativo. O valor padrão é Primário. |
| Endereço | nomePróprio | string | O nome fornecido pelo usuário que está associado ao endereço. |
| Endereço | apelido | string | O sobrenome fornecido pelo usuário que está associado ao endereço. |
| Endereço | phoneNumber | string | O número de telefone fornecido pelo usuário que está associado ao endereço. |
| Endereço | rua1 | string | A primeira linha que foi fornecida para o endereço. |
| Endereço | rua2 | string | A segunda linha que foi fornecida para o endereço. (Este valor pode estar em branco.) |
| Endereço | rua3 | string | A terceira linha que foi fornecida para o endereço. (Este valor pode estar em branco.) |
| Endereço | cidade | string | A cidade que foi fornecida para o endereço. |
| Endereço | state | string | O estado ou província que foi fornecido para o endereço. |
| Endereço | Distrito | string | O distrito que foi fornecido para o endereço. |
| Endereço | CEP | string | O código postal que foi fornecido para o endereço. |
| Endereço | CountryRegion | string | O código de país/região fornecido para o endereço. O valor deve ser um código ISO de país/região de duas letras (por exemplo, EUA). |
| PaymentInstrument | merchantPaymentInstrumentId | string | O identificador do instrumento de pagamento. Estas 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 | criaçãoData de criação | DateTime | A data da primeira entrada do instrumento de pagamento no sistema do comerciante. O formato é ISO 8601. |
| PaymentInstrument | updateDate | DateTime | A data da última atualização do instrumento de pagamento no sistema do comerciante. O formato é ISO 8601. |
| PaymentInstrument | state | string | O estado atual do instrumento de pagamento no sistema do comerciante (por exemplo, Ativo, Bloqueado ou Expirado). |
| PaymentInstrument | tipo de cartão | string | Este atributo é usado apenas para pagamentos dos tipos CreditCard ou DirectDebit . Os valores possíveis são Visa, Mastercard, Amex, ACH, SEPA, UnionPay, Inicis, MobileBillingCarrier, Discover, AllPay, JCB e DiscoverDiners. |
| PaymentInstrument | holderName [en] | string | O nome do utilizador do instrumento de pagamento. Este atributo é usado apenas para pagamentos dos tipos DirectDebit CreditCard. |
| PaymentInstrument | classe | string | Este atributo é usado apenas para pagamentos dos tipos CreditCard ou DirectDebit . |
| PaymentInstrument | Data de expiração | string | A data de expiração do instrumento de pagamento no sistema do comerciante. O formato é ISO 8601. Este atributo é usado apenas para pagamentos dos tipos CreditCard ou DirectDebit . |
| PaymentInstrument | últimoQuatroDígitos | string | Este atributo é usado apenas para pagamentos dos tipos CreditCard ou DirectDebit . |
| PaymentInstrument | Correio eletrónico | string | O endereço de e-mail associado ao instrumento de pagamento. Este atributo é usado apenas para pagamentos do tipo PayPal . |
| PaymentInstrument | billingAgreementId | string | Este atributo é usado apenas para pagamentos do tipo PayPal . |
| PaymentInstrument | payerId | string | Este atributo é usado apenas para pagamentos do tipo PayPal . |
| PaymentInstrument | pagadorStatus | string | Um valor que indica se PayPal verificou o ordenante. Este atributo é usado apenas para pagamentos do tipo PayPal . |
| PaymentInstrument | endereçoStatus | string | Um valor que indica se PayPal verificou o endereço do ordenante. Este atributo é usado apenas para pagamentos do tipo PayPal . |
| PaymentInstrument | IMEI | string | Este atributo é usado apenas para pagamentos do tipo MobileBilling . |
| PaymentInstrument \ Endereço de Faturação | addressType | enumeração | O tipo de endereço. Os valores possíveis são Principal, Faturamento, Frete e Alternativo. O valor padrão é Faturamento. |
| PaymentInstrument \ Endereço de Faturação | nomePróprio | string | O nome fornecido pelo usuário que está associado ao endereço. |
| PaymentInstrument \ Endereço de Faturação | apelido | string | O sobrenome fornecido pelo usuário que está associado ao endereço. |
| PaymentInstrument \ Endereço de Faturação | phoneNumber | string | O número de telefone fornecido pelo usuário que está associado ao endereço. |
| PaymentInstrument \ Endereço de Faturação | rua1 | string | A primeira linha que foi fornecida para o endereço. |
| PaymentInstrument \ Endereço de Faturação | rua2 | string | A segunda linha que foi fornecida para o endereço. (Este valor pode estar em branco.) |
| PaymentInstrument \ Endereço de Faturação | rua3 | string | A terceira linha que foi fornecida para o endereço. (Este valor pode estar em branco.) |
| PaymentInstrument \ Endereço de Faturação | cidade | string | A cidade que foi fornecida para o endereço. |
| PaymentInstrument \ Endereço de Faturação | state | string | O estado ou província que foi fornecido para o endereço. |
| PaymentInstrument \ Endereço de Faturação | Distrito | string | O distrito que foi fornecido para o endereço. |
| PaymentInstrument \ Endereço de Faturação | CEP | string | O código postal que foi fornecido para o endereço. |
| PaymentInstrument \ Endereço de Faturação | CountryRegion | string | O código de país/região fornecido para o endereço. O valor deve ser um código ISO de país/região de duas letras (por exemplo, EUA). |
Etiquetas
A API de Etiquetas permite compartilhar informações adicionais sobre os resultados de transações e eventos para treinamento de modelo baseado em um conjunto adicional de sinais de fraude. Estas informações incluem informações que recebe dos bancos. Este evento é apenas um evento de ingestão de dados.
| Categoria | Atributo | Tipo | Description |
|---|---|---|---|
| Name | string | O valor é AP. AccountLabel. | |
| Versão | string | O valor é 0,5. | |
| Metadados | TrackingId | String | O ID exclusivo para cada evento/registro. |
| Metadados | merchantTimeStamp | DateTime | A data, no fuso horário do comerciante. O formato é ISO 8601. |
| Metadados | ID de Utilizador | string | O identificador do usuário. Estas informações são fornecidas pelo comerciante. |
| Etiqueta | EventTimeStamp | DateTime | A data e hora do evento. Os valores possíveis são a data do estorno e a data da revisão. O formato é ISO 8601. |
| Etiqueta | LabelObjectType | enumeração | O tipo de etiqueta: Compra, Criação de Conta, Login de Conta, Atualização de Conta, Avaliação de Fraude Personalizada, Conta, Instrumento de Pagamento ou E-mail. |
| Etiqueta | LabelObjectId | String | O campo identificador do objeto: PurchaseId, AccountCreationId, AccountLoginId, AccountUpdateId, UserId, MerchantPaymentInstrumentId ou Email. |
| Etiqueta | LabelSource | enumeração | A origem do rótulo: Escalonamento do cliente, Estorno, TC40_SAFE, Revisão manual, Reembolso, Análise offline ou Revisão da proteção da conta. |
| Etiqueta | LabelState | enumeração | O status atual do rótulo: Consulta Aceita, Fraude, Disputado, Revertido, Abuso, Solicitação Reenviada, ContaComprometida ou ContaNão Comprometida. |
| Etiqueta | LabelReasonCodes | enumeração | Os códigos de motivo associados a cada tipo de etiqueta: Código de resposta do processador/banco, Reembolso de fraude, Tomada de conta, Fraude de instrumento de pagamento, Fraude de conta, Abuso, Fraude amigável, Credenciais de conta vazadas ou Verificações de proteção de conta aprovadas. |
| Etiqueta | Processador | String | O nome do banco ou processador de pagamento que gera as informações TC40 ou Sistema para Evitar Fraudes Eficazes (SAFE). |
| Etiqueta | EffectiveStartDate | DateTime | A data em que este rótulo entra em vigor. O formato é ISO 8601. |
| Etiqueta | EffectiveEndDate | DateTime | A data final para este rótulo. O formato é ISO 8601. |