Partilhar via

Ver esquemas de proteção de compra

  • Artigo

Este artigo descreve os esquemas para APIs em tempo real e dados históricos que são carregados em massa na Proteção contra Fraude do Microsoft Dynamics 365. Para obter informações sobre o procedimento de carregamento, consulte Carregar dados históricos. Se os dados forem ingeridos por meio da interface de programação de aplicativos (API), consulte Integrar APIs em tempo real do Dynamics 365 Fraud Protection.

Siga estes requisitos:

  • Os arquivos estão no formato CSV UTF-8 (vírgula, ponto-e-vírgula ou delimitado por tabulações) (*.csv ou *.tsv).
  • O tamanho máximo do ficheiro é de 10 gigabytes (GB).
  • Os seguintes caracteres são escapados em todas as colunas: vírgulas/ponto-e-vírgula, novos caracteres de linha e caracteres de várias linhas.
  • As colunas 'datetime' estão no formato ISO 8601. Por exemplo, em C# DateTime.UtcNow.ToString("o") teria o formato "2019-03-14T20:18:11.254Z".
  • A precisão da coluna «dupla» (decimal) é de duas casas decimais.

Transações

Os esquemas a seguir são usados na avaliação e proteção de experiências.

Compras

Atributo Tipo Description
PurchaseId String O identificador da transação (ou compra ou ordem).
OriginalOrderId String O identificador de pedido original para pagamentos de cobrança recorrente, como cobrança de assinatura mensal.
CustomerLocalDate DateTime A data de criação da compra no fuso horário local do cliente. O formato é ISO 8601.
MerchantLocalDate DateTime A data de ingestão da compra no fuso horário local do comerciante. O formato é ISO 8601.
TotalMontante Duplo O valor total que foi cobrado ao cliente, incluindo impostos. Estas informações são fornecidas pelo comerciante.
Imposto sobre vendas Duplo O imposto sobre vendas cobrado pela transação. Estas informações são fornecidas pelo comerciante.
Moeda String A moeda da compra original como um código de moeda de três caracteres (por exemplo: USD, que está alinhado com o código de moeda OANDA). Estas informações são fornecidas pelo comerciante.
DeviceContextId String A ID de sessão da sessão do evento (fornecida pelo Microsoft Device Fingerprinting) ou a ID da transação se a sessão não estiver disponível.
IPAddress String O endereço IP do cliente. Essas informações são fornecidas pelo Microsoft Device Fingerprinting.
UserId String O identificador do cliente. Estas informações são fornecidas pelo comerciante. Este atributo é obrigatório.
UserFirstName String O primeiro nome fornecido pelo cliente na conta do cliente.
Sobrenome do usuário String O sobrenome fornecido pelo cliente na conta do cliente.
E-mail do usuário String O endereço de e-mail do cliente. Esse valor não diferencia maiúsculas de minúsculas.
UserCreationDate DateTime A data de criação da conta de cliente. O formato é ISO 8601.
UserUpdateDate DateTime A data em que os dados do cliente foram alterados pela última vez. O formato é ISO 8601.
UserZipCode String O código postal do cliente.
UserCountryCode String País ou região do cliente. O valor deve ser um código de país ou região de duas letras (por exemplo: EUA).
UserTimeZone String Uma cadeia de caracteres vazia.
Linguagem do usuário String O idioma e o território linguístico do cliente (por exemplo: EN-US).
Número de telefone do usuário String O número de telefone do cliente. O formato deve ser o código do país ou região seguido de um hífen (-) e, em seguida, o número de telefone (por exemplo: para os EUA, +1-1234567890).
IsEmailValidated Boolean Um valor True/False que indica se o endereço de e-mail fornecido pelo cliente foi verificado como de propriedade do cliente.
EnvioPrimeiroNome String O primeiro nome que foi fornecido para o endereço.
EnvioSobrenome String O sobrenome que foi fornecido para o endereço.
ShippingPhoneNumber String O número de telefone que foi fornecido para o endereço. O formato deve ser o código do país ou região seguido de um hífen (-) e, em seguida, o número de telefone (por exemplo: para os EUA, +1-1234567890).
Rua1 String A primeira linha que foi fornecida para o endereço.
Rua2 String A segunda linha que foi fornecida para o endereço. (Este valor pode estar em branco.)
Rua3 String A terceira linha que foi fornecida para o endereço. (Este valor pode estar em branco.)
Localidade String A cidade que foi fornecida para o endereço.
Distrito String O estado ou província que foi fornecido para o endereço.
Código Postal String O código postal que foi fornecido para o endereço.
CountryCode String O código de país ou região fornecido para o endereço. O valor deve ser um código ISO de país ou região de duas letras (por exemplo: EUA).
Dados Personalizados Object Um pacote de propriedades JSON (JavaScript Object Notation) opcional definido pelo usuário. Ele é preenchido quando uma chamada de API é instanciada. Os atributos podem ser referenciados quando você cria regras de compra.

Nota:

  • Os seguintes tipos primitivos são suportados: String (Unicode), Int32, UInt32, Double, Boolean e DateTime (em Tempo Universal Coordenado [UTC], em conformidade com a semântica do .NET).
  • O limite de dados da cadeia de caracteres é de 256 caracteres.
  • Há um limite de 100 atributos personalizados por carga útil.
  • Não envie tipos de dados confidenciais ou altamente regulamentados. Seguem-se alguns exemplos:
    • Dados que indiquem uma classe protegida (como género ou raça) ou categorias privadas/sensíveis (como opiniões religiosas ou orientação sexual)
    • Dados biométricos ou quaisquer dados relacionados com a saúde
  • A política de retenção de dados personalizada corresponde à política de retenção do evento de compra (seis meses).

Para obter um exemplo que mostra como usar APIs de compra com um objeto de dados personalizado na Proteção contra fraude, consulte a seção Exemplo de dados personalizados no final deste artigo.
MerchantBusinessType String A vertical do negócio ou da indústria (por exemplo: jogos, varejo, restaurantes ou redes sociais).
MerchantIdentifier String O ID do comerciante (MID) é um número de identificação específico associado a uma empresa que informa os sistemas de processamento de pagamentos envolvidos numa transação para onde enviar que fundos. Você pode pensar nisso como um endereço para o seu negócio. Por exemplo, se não tiver um ID de comerciante, as redes envolvidas não saberão para onde enviar o seu dinheiro.
MerchantCategoryCode String O código de categoria do comerciante (MCC) é um número de quatro dígitos listado na ISO 18245 para serviços financeiros de varejo. Um CCM é utilizado para classificar uma empresa pelos tipos de bens ou serviços que fornece.
MerchantBusinessSegmento String A subsecção das operações gerais de um comerciante em que existe uma linha de produtos, linha de negócio ou marca subordinada estabelecida e separada (por exemplo: Xbox ou Surface).
MerchantProductCategory String A categoria de produto ou serviço definida pelo comerciante.
StoreId String O identificador da loja.
StoreName String O nome de exibição da loja.
Endereço da Loja String O endereço completo (rua, cidade, estado, zip) da loja.
IsTest Boolean Um valor que indica se a transação é um teste na produção.
IsFreeProductIncluded Boolean Um valor que indica se um produto gratuito está incluído na transação.
IsGuestCheckout Boolean Um valor que indica se a compra foi feita como convidado.
IsPostAuthCheck Boolean Um valor que indica se houve uma verificação pós-autenticação.
IsRecurringCharge Boolean Um valor que indica se a transação foi uma assinatura/recorrente.
RecurringChargeFrequencyInDays Duplo Com que frequência a compra recorrente está sendo cobrada, por exemplo, a cada 30 dias, a cada semestre, a cada ano, etc.
RecurringChargeStartDate DateTime A data de início de uma transação recorrente.
RecurringChargeEndDate DateTime A data final de uma transação recorrente.
IsPostpaid Boolean Um valor que indica se uma transação é pós-paga ou não.
DiscountAmount Duplo O valor do desconto aplicado à transação. Por exemplo, se um usuário comprar 10 dos mesmos controladores XBOX, esse item será o número 1. Ou, se um usuário comprar 5 jogos diferentes e 10 dos mesmos controladores XBOX, este item será o número 5+1 ou 6.
TipAmount Duplo O valor da gorjeta aplicado à transação.
DistinctItemCount Duplo A contagem de itens distintos/exclusivos por transação.
TotalItemCount Duplo A contagem total de itens por transação. Por exemplo, se um usuário comprar 10 dos mesmos controladores XBOX, esse item será o número 10. Ou, se um usuário comprar 5 jogos diferentes e 10 dos mesmos controladores XBOX, este item será o número 5+10 ou 15.
IsLowLiabilityPIType Boolean Um valor que indica instrumentos de pagamento de baixa responsabilidade (por exemplo: Apple Pay, Alipay ou UnionPay).
Tipo de Encomenda String O tipo de transação (por exemplo: takeout).
IsRetryOrder Boolean Um valor que indica se a ordem foi repetida.
AttemptId String O identificador de cada nova tentativa de transação.
Data de envio DateTime A data em que a encomenda foi enviada.
OrderInitiatedChannel String O canal onde a transação foi criada (por exemplo: 'AppStore', 'Web', MobileWeb, 'App', 'InGamePurchase').
OrderInitiatedChannelName String O Nome do Aplicativo ou URL da Web onde a transação foi criada.
OrderInitiatedChannelRegionORCountry String O mercado onde a transação foi criada (por exemplo: Mercado de aplicativos).
MerchantBusinessSubsegmentoL2 String O segundo nível (L2) segmento de negócios ou indústria.
Nome Médio String O nome do comerciante associado ao MID (identificador do comerciante).
TransaçãoProcessamentoOrdem String A ordem em que a avaliação da fraude foi feita durante o fluxo da transação.
RecurringSubscriptionId String O ID exclusivo para a cobrança recorrente
RecurringChargeSequence Int32 A enésima (1, 2, 3...) vez que a cobrança recorrente ocorreu para este cliente.
Descrição da transação String O tipo de processamento de transação
Nível de Organização1 Object O nível superior da hierarquia da organização.
OrganizaçãoNível2 Object O nível médio da hierarquia da organização.
Nível de Organização3 Object O nível mais baixo da hierarquia da organização.
TrêsDS Object Consulte a seção ThreeDS.
RecipientUser Object Consulte a seção do usuário.
Visão Geral da Viagem Object Consulte a seção TravelOverview de atributos específicos verticais.
CloudBusiness Object Consulte a seção Atributos específicos verticais do CloudBusiness.
Tipo de associação String O status ou tipo de associação do cliente. Diferentes níveis podem ser especificados, como Premium e Executive.
AuthenticationMethod String A forma como o cliente foi autenticado antes/durante a compra.
LoginInputMethod String A maneira como o cliente insere suas credenciais.
LastPasswordUpdatedDate DateTimeOffset Quando a senha do cliente foi atualizada pela última vez.
FirstPurchaseDate DateTimeOffset Quando o cliente fez a sua primeira compra
LoginChallengeType String O tipo de teste de desafio-resposta que foi iniciado.
Assinatura Http String A assinatura digital da mensagem HTTP.
HttpUserAgent String O cabeçalho da solicitação usado para identificar o aplicativo, o sistema operacional, o fornecedor e/ou a versão.
BrowserHeader String A lista completa de cabeçalhos de solicitação enviados pelo navegador.
Resolução do navegador String A resolução do navegador.
BrowserLanguage String A preferência de idioma padrão do navegador.
TcpAssinatura String A assinatura do aplicativo TCP.
Assinatura SslSignature String A assinatura SSL.
AtivadoCookies Boolean Um valor True/False que indica se os cookies estão ativados.
EnabledFlash Boolean Um valor True/False que indica se o Flash está ativado.
EnabledJavaScript Boolean Um valor True/False que indica se o JavaScript está habilitado.
ScreenAspectRatio String A proporção do navegador.
Profundidade de TelaColorProfundidade String A profundidade de cor da tela.
Resolução de tela String Resolução da tela do dispositivo em pixels
SiteHostName String O nome de host do site.
SO String O sistema operacional do dispositivo.
OSFonts String A fonte padrão do sistema operacional.
DeviceProcessor String O processador do dispositivo.
SessionId String O ID de sessão exclusivo.
TrueIp String Endereço IP verdadeiro do dispositivo identificado pela impressão digital do dispositivo
ProxyIp String Endereço IP do dispositivo proxy.
DeviceId String GUID exclusivo por dispositivo gerado pela impressão digital do dispositivo
TimeZone String Deslocamento do fuso horário local, em horas, em relação ao GMT
UserAgentDetails String Detalhes adicionais do agente do usuário ou do navegador.
AppVersion String Versão do aplicativo.
BrowserPackagesList String Lista de pacotes instalados no dispositivo.
ConstruirFabricante String Fabricante do dispositivo.
Modelo de construção String Nome visível do usuário para o produto final.
BuildSdkVersion String Versão de compilação.
DataNetworkType String Tipo de rede de dados móveis.
DeviceModelName String Modelo do dispositivo.
DeviceSystemName String Nome do dispositivo da máquina.
DeviceSystemVersion String Versão do dispositivo.
IsBluetoothEnabled Boolean Um valor True/False que indica se o Bluetooth foi ativado.
SimNetworkCountryISO String Código ISO do país para o fornecedor de serviços móveis.
SimNetworkType String Tipo de rede móvel.
SystemUpTime String A duração do tempo que o dispositivo esteve funcionando e disponível.
PaymentMethod String A categoria de método de pagamento de nível superior.
IsLowLiabilityPIType Boolean Um valor Verdadeiro/Falso que indica se o método de pagamento é de baixa responsabilidade.
HolderCompanyName Boolean Nome da organização que fornece o cartão de empresa (apenas para compras comerciais).
LiquidaçãoAprovaçãoNecessária Boolean Um valor Verdadeiro/Falso que indica se foi ou não necessária aprovação para uma transação SEPA.
PagamentoCheckoutProvider String O provedor de checkout de carteira eletrônica.
Nome do compartimento String O nome de exibição do BIN.
BinCountryISO String O código ISO do país associado ao BIN.
BinCardType String O tipo de cartão BIN.
BinCardAssociação String A associação do cartão BIN.
BinBankGroup [en] String O grupo BIN bank.
Moeda String Código da moeda do instrumento de pagamento selecionado.
IsInternationalMoneyTransfer Boolean Um valor Verdadeiro/Falso que indica se ocorreu uma transferência internacional de dinheiro.
BankIdentifierCode String Código de identificação bancária (código BIC ou SWIFT)
Nome do Banco String O nome do banco.
BankZipCode String O CEP do banco.
BankState [en] String O estado do banco.
BankCountryISO String O país ISO do banco.
PaymentCollectionDate DateTimeOffset A data estimada para a cobrança do pagamento (utilizada principalmente para os prestadores de serviços de pagamento).
InstantPaymentSettlement Boolean Um valor Verdadeiro/Falso indicando redirecionamentos bancários (usado para suportar pagamentos CSV).
AutoCaptureEnabled Boolean Um valor Verdadeiro/Falso que indica se o pagamento foi capturado automaticamente para pagamentos com cartão. Para pagamentos de redirecionamento, isso é simplesmente um indicador para o banco parceiro se deve retirar fundos automaticamente ou não.
Tipo de Conta String Indica o tipo de conta a ser cobrada pela transação. UNSPECIFIED é o padrão. CHEQUE_ACCOUNT usa o cartão como um cartão de débito. CREDIT_FACILITY usa o cartão como cartão de crédito.
Tipo de autorização String O tipo de autorização. A Mastercard e a Visa exigem agora que os comerciantes definam as tentativas de autorização como uma pré-autorização ou uma autorização final.
AuthorizationResultCode String Resposta bancária da decisão de autorização.
AuthorizationResultText String Razões para a decisão de autorização, especialmente para transações recusadas ou pendentes.
AcquirerId String Código de identificação da instituição adquirente.
AcquirerCountryISO String Código do país da instituição adquirente.
CvvVerify String Indica se a verificação CVV está disponível e/ou verificada com êxito.
  • Y = Verificado com êxito
  • N = Não verificado com êxito
  • U = Indisponível
  • A = Disponível, mas sem verificação
AvsVerify String Indica se a verificação de endereço está disponível e/ou verificada com êxito.
  • Y = Verificado com êxito
  • N = Não verificado com êxito
  • U = Indisponível
  • A = Disponível, mas sem verificação
CavVerify String Indica se a verificação de autenticação do titular do cartão está disponível e/ou foi verificada com êxito.
  • Y = Verificado com êxito
  • N = Não verificado com êxito
  • U = Indisponível
  • A = Disponível, mas sem verificação
EncryptedCreditCardNumber String O número do cartão de crédito com hash ou criptografado.
ID Organização String O identificador exclusivo do comerciante ou da organização.
Nome Cadeia (de carateres) O nome da organização.
Código Postal String O CEP onde a organização está localizada.
Distrito String O estado onde a organização está localizada.
PaísISO String O código ISO do país para onde a organização está localizada.
ProductBrand String Marca do produto.
BuyItAgainOrder Boolean True quando os usuários re-encomendam um pedido anterior (não apenas um produto desse pedido).
PreOrderAvailabilityDate DateTimeOffset Quando o produto foi disponibilizado pela primeira vez para pré-encomenda.
ID do terminal String O identificador único do terminal do ponto de venda.
Nome do terminal String O nome do terminal do ponto de venda.
IsThreeDSAuth Boolean Um valor True/False que indica se essa transação é autenticada via 3DS.
MensagemCategoria String Identifica a categoria da mensagem para um caso de uso específico.
DeviceChannel String Indica o tipo de interface de canal que está sendo usado para iniciar a transação.
TrêsDSServerTransId String Identificador de transação universalmente exclusivo atribuído pelo Servidor 3DS para identificar uma única transação.
ThreeDSRequestorAuthenticationInd String Indica o tipo de solicitação de autenticação.
TrêsRIInd String Indica o tipo de solicitação 3RI.
Método ThreeDSReqPriorAuthMethod String Mecanismo utilizado pelo Titular do Cartão para autenticação prévia ao Requerente 3DS.
Transstatus String Indica se uma transação se qualifica como uma transação autenticada ou verificação de conta.
TransStatusReason String Fornece informações sobre por que o campo Status da transação tem o valor especificado.
TrêsDSCompInd String Indica se o Método 3DS foi concluído com êxito.
AcsChallengeMandated String Indicação de se é necessário um desafio para que a transação seja autorizada devido a mandatos locais/regionais ou outra variável.
ThreeDSRequestorChallengeInd String Indica se uma contestação é solicitada para esta transação.
DesafioCompletionInd String Indicador do estado do ciclo de desafio do ACS e se o desafio foi concluído ou exigirá mensagens adicionais.
Valores aceites:
Eci String Indicador de Comércio Eletrónico (ICE). Valor específico do sistema de pagamento fornecido pelo ACS ou DS para indicar os resultados da tentativa de autenticação do titular do cartão.
ShipNameIndicator String Indica se o Nome do Titular do Cartão na conta é idêntico ao Nome de envio usado para esta transação.
SuspeitoAccActivity String Indica se o solicitante do 3DS teve atividade suspeita (incluindo fraude anterior) na conta do titular do cartão.
ChAccPwChangeInd String Indica o período de tempo desde que a conta do titular do cartão com o solicitante 3DS teve uma alteração de senha ou redefinição de conta.
ChAccAgeInd String Período de tempo em que o titular do cartão teve a conta com o solicitante 3DS.
ProvisionAttemptsDay String Número de tentativas de Adicionar Cartão nas últimas 24 horas.
Comprimento: máximo 3 caracteres.

Exemplos de valores:
  • 2
  • 02
  • 002
IsençãoAngariada String

Pedidos de isenção da DSP2.

  • Y - isento
  • N- Não isento

Instrumentos de Pagamento

Atributo Tipo Description
PurchaseId String O identificador da transação (ou compra ou ordem).
MerchantPaymentInstrumentId String O identificador do instrumento de pagamento. Estas informações são fornecidas pelo comerciante. Este é um atributo obrigatório.
Type String O tipo de pagamento. Para obter mais informações, consulte API de proteção contra fraude do Dynamics 365.
CompraMontante Duplo O valor total da compra que utiliza este instrumento de pagamento para a transação.
CreationDate DateTime A data da primeira entrada do instrumento de pagamento no sistema do comerciante. O formato é ISO 8601.
UpdateDate DateTime A data da última atualização do instrumento de pagamento no sistema do comerciante. O formato é ISO 8601.
Tipo de Cartão String Este atributo é usado apenas para pagamentos do tipo Cartão de Crédito .
Nome do Titular String O nome do cliente do instrumento de pagamento. Este atributo é usado apenas para pagamentos do tipo Cartão de Crédito .
COMPARTIMENTO String Este atributo é usado apenas para pagamentos do tipo Cartão de Crédito .
Data de validade String A data de expiração do instrumento de pagamento no sistema do comerciante. O formato é ISO 8601. Este atributo é usado apenas para pagamentos do tipo Cartão de Crédito .
ÚltimoQuatroDígitos String Este atributo é usado apenas para pagamentos do tipo Cartão de Crédito .
Correio Eletrónico String O endereço de e-mail associado ao instrumento de pagamento. Este atributo é usado apenas para pagamentos do tipo PayPal .
BillingAgreementId String Este atributo é usado apenas para pagamentos do tipo PayPal .
PayerId String Este atributo é usado apenas para pagamentos do tipo PayPal .
Estatuto do Pagador String Um valor que indica se PayPal verificou o ordenante. Este atributo é usado apenas para pagamentos do tipo PayPal .
EndereçoStatus String Um valor que indica se PayPal verificou o endereço do ordenante. Este atributo é usado apenas para pagamentos do tipo PayPal .
IMEI String Este atributo é usado apenas para pagamentos do tipo Mobilepayment .
FirstName String O primeiro nome que foi fornecido para o endereço.
LastName String O sobrenome que foi fornecido para o endereço.
PhoneNumber String O número de telefone que foi fornecido para o endereço. O formato deve ser o código do país ou região seguido de um hífen (-) e, em seguida, o número de telefone (por exemplo: para os EUA, +1-1234567890).
Rua1 String A primeira linha que foi fornecida para o endereço.
Rua2 String A segunda linha que foi fornecida para o endereço. (Este valor pode estar em branco.)
Rua3 String A terceira linha que foi fornecida para o endereço. (Este valor pode estar em branco.)
Localidade String A cidade que foi fornecida para o endereço.
Distrito String O estado ou província que foi fornecido para o endereço.
Código Postal String O código postal que foi fornecido para o endereço.
CountryCode 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 ou região de duas letras (por exemplo: EUA).
PISource String A origem do instrumento de pagamento (por exemplo: CustomerInput, FromSavedProfile, MobilePay).

Produtos

Atributo Tipo Description
PurchaseId String O identificador da transação (ou compra ou ordem).
ProductId String O identificador do produto. Este é um atributo obrigatório.
Preço de Compra Duplo O preço do item de linha da compra.
Margin String A margem que foi ganha com a venda do item.
Quantidade Int32 O número de itens que foram comprados.
ProductName String O nome do produto legível pelo cliente.
Type String Um valor que indica se os bens eram físicos ou digitais.
Categoria String A categoria do produto (por exemplo: Vestuário, Sapatos ou Acessórios).
Comercializar String O mercado onde o produto é oferecido. O valor deve ser um código ISO de país ou região de duas letras (por exemplo: EUA).
Sku String A unidade de manutenção de estoque (SKU) do produto.
Preço-de-venda Duplo O preço do item que foi vendido sem impostos. Estas informações são fornecidas pelo comerciante.
Moeda String A moeda da compra original como um código de moeda de três caracteres (por exemplo: USD, que está alinhado com o código de moeda OANDA). Estas informações são fornecidas pelo comerciante.
COGS Duplo O custo dos bens vendidos (ou seja, o custo da matéria-prima do item). Estas informações são fornecidas pelo comerciante.
ÉRecorrente Boolean Um valor que indica se o produto é uma assinatura recorrente.
IsFree Boolean Um valor que indica se o produto é oferecido gratuitamente.
Idioma String A língua e o território linguístico (por exemplo: EN-US).

Estornos

O esquema a seguir é usado na avaliação e proteção de experiências.

Atributo Tipo Description
ChargebackId String O identificador de estorno.
Razão String O motivo que foi fornecido pelo banco.
Estado String O status. Para obter mais informações, consulte API de proteção contra fraude do Dynamics 365.
BankEventTimestamp DateTime O carimbo de data/hora do banco. O formato é ISO 8601.
Montante Duplo O valor do estorno.
Moeda String A moeda usada para o valor do estorno.
UserId String O identificador do cliente.
PurchaseId String O identificador da transação (ou compra ou ordem).
MerchantLocalDate DateTime A data de ingestão da compra no fuso horário local do comerciante. O formato é ISO 8601.

Reembolsos

O esquema a seguir é usado na avaliação e proteção de experiências.

Atributo Tipo Description
RefundId String O identificador de reembolso.
Razão String O motivo fornecido pelo cliente.
Estado String O status do reembolso. Para obter mais informações, consulte API de proteção contra fraude do Dynamics 365.
BankEventTimestamp DateTime O carimbo de data/hora do banco. O formato é ISO 8601.
Montante Duplo O valor do reembolso.
Moeda String A moeda usada para o valor do preço de venda.
UserId String O identificador do cliente. Este é um atributo obrigatório.
PurchaseId String O identificador da transação (ou compra ou ordem).
MerchantLocalDate DateTime Uma data no formato ISO 8601.

PurchaseStatus

O esquema a seguir é usado na avaliação e proteção de experiências.

Atributo Tipo Description
PurchaseId String O identificador da transação (ou compra ou ordem).
StatusType String O tipo de status. Para obter mais informações, consulte API de proteção contra fraude do Dynamics 365.
StatusDate DateTime A data e a hora em que o status foi aplicado. O formato é ISO 8601.
Razão String O motivo da transição de status.
MerchantLocalDate DateTime Uma data no formato ISO 8601.

Eventos Bancários

O esquema a seguir é usado na avaliação e proteção de experiências.

Atributo Tipo Description
BankEventId String O identificador de evento bancário.
Type String O tipo de evento bancário. Para obter mais informações, consulte API de proteção contra fraude do Dynamics 365.
BankEventTimestamp DateTime O carimbo de data/hora do banco. O formato é ISO 8601.
Estado String O status. Para obter mais informações, consulte API de proteção contra fraude do Dynamics 365.
BankResponseCode String O código bancário na resposta.
PaymentProcessor String O nome do processador (por exemplo: FDC ou PayPal).
MRN String O Número de Referência do Comerciante (MRN) utilizado para identificar a transação no lado do comerciante.
MID String O ID do comerciante (MID) que é usado para comunicação bancária.
PurchaseId String O identificador da transação (ou compra ou ordem).
MerchantLocalDate DateTime Uma data no formato ISO 8601.
MerchantPaymentInstrumentId String Cenário de PI múltiplo ou cenário de alteração de PI.
PaymentMethod String Agrupamentos/categorias de métodos de pagamento.
Tipo de Cartão String O tipo de pagamento.
AtualizadoPI String Usou PI diferente do da compra?
CvvVerify String Indica se a verificação CVV está disponível e/ou verificada com êxito.
  • Y = Verificado com êxito
  • N = Não verificado com êxito
  • U = Indisponível
  • A = Disponível, mas sem verificação
AvsVerify String Indica se a verificação de endereço está disponível e/ou verificada com êxito.
  • Y = Verificado com êxito
  • N = Não verificado com êxito
  • U = Indisponível
  • A = Disponível, mas sem verificação
CavVerify String Indica se a verificação de autenticação do titular do cartão está disponível e/ou foi verificada com êxito.
  • Y = Verificado com êxito
  • N = Não verificado com êxito
  • U = Indisponível
  • A = Disponível, mas sem verificação
AuthorizationResultCode String Resposta bancária da decisão de autorização.
AuthorizationResultText String Fundamentação da decisão de autorização; especialmente para transações recusadas ou pendentes.
TrêsDS String Consulte a seção Comprar ThreeDS na Folha de compras.

Account

Os esquemas a seguir são usados na avaliação e proteção de experiências.

AtualizarConta

Atributo Tipo Description
CustomerLocalDate DateTime Uma data no formato ISO 8601.
UserId String O identificador do cliente. Este é um atributo obrigatório.
UsercreationDate DateTime Uma data no formato ISO 8601.
UserupdateDate DateTime Uma data no formato ISO 8601.
FirstName String O primeiro nome fornecido pelo cliente na conta do cliente.
LastName String O sobrenome fornecido pelo cliente na conta do cliente.
CountryCode String País ou região do cliente. O valor deve ser um código de país ou região de duas letras (por exemplo: EUA).
Código Postal String O código postal do cliente.
TimeZone String Este atributo está obsoleto (obsoleto). Forneça uma cadeia de caracteres vazia como o valor.
Idioma String O idioma e o território linguístico do cliente (por exemplo: EN-US).
PhoneNumber String O número de telefone do cliente. 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).
Correio Eletrónico String O endereço de e-mail do cliente. Esse valor não diferencia maiúsculas de minúsculas.
IsEmailValidated Boolean Um valor que indica se o e-mail fornecido pelo cliente foi verificado como de propriedade do cliente.
EmailValidatedDate DateTime A data em que o e-mail fornecido pelo cliente foi verificado como propriedade do cliente. O formato é ISO 8601.
IsPhoneNumberValidated Boolean Um valor que indica se o número de telefone fornecido pelo cliente foi verificado como de propriedade do cliente.
TelefoneNúmeroData Validada DateTime A data em que o número de telefone fornecido pelo cliente foi verificado como de propriedade do cliente. O formato é ISO 8601.
DeviceContextId String A ID de sessão da sessão do evento (fornecida pelo Microsoft Device Fingerprinting) ou a ID da transação se a sessão não estiver disponível.
Provider String Um valor que indica a origem do valor deviceContextId : DFP Fingerprinting ou Merchant.
DeviceContextDC String O centro de dados Microsoft Device Fingerprinting para o ID de sessão do cliente.
ExternalDeviceId String O ID do dispositivo do cliente. Estas informações são fornecidas e dominadas pelo comerciante.
ExternalDeviceType String O tipo de dispositivo identificado pelo comerciante (por exemplo: PC ou Dispositivo Móvel).
Endereço IP String O endereço IP do cliente. Essas informações são fornecidas pelo Microsoft Device Fingerprinting.
MerchantLocalDate DateTime Uma data no formato ISO 8601.
Tipo de associação String O status ou tipo de associação do cliente.
LoginInputMethod String O método que o cliente usa para inserir suas credenciais.
LastPasswordUpdatedDate String Quando a senha do cliente foi atualizada pela última vez.
FirstPurchaseDate String Quando o cliente fez a sua primeira compra.
LoginChallengeType String O tipo de teste de desafio-resposta que foi iniciado.
Lista de endereços String Consulte a seção Endereço de compra.
PaymentInstrumentList String Consulte a seção Purchase PaymentInstrumentList.
DeviceContext String Consulte a seção Comprar DeviceContext.

UpdateAddress

Atributo Tipo Description
UserId String O identificador do cliente. Este é um atributo obrigatório.
Tipo de endereço String O tipo de endereço: Faturação, Envio, Conta ou Desconhecido.
FirstName String O primeiro nome que foi fornecido para o endereço.
LastName String O sobrenome que foi fornecido para o endereço.
PhoneNumber String O número de telefone que foi fornecido para o endereço.
Rua1 String A primeira linha que foi fornecida para o endereço.
Rua2 String A segunda linha que foi fornecida para o endereço. (Este valor pode estar em branco.)
Rua3 String Terceira linha que foi fornecida para o endereço. (Este valor pode estar em branco.)
Localidade String A cidade que foi fornecida para o endereço.
Distrito String O estado ou província que foi fornecido para o endereço.
Distrito String O distrito que foi fornecido para o endereço. (Este valor pode estar em branco.)
Código Postal String O código postal que foi fornecido para o endereço.
CountryCode String O código de país ou região fornecido para o endereço. O valor deve ser um código ISO de país ou região de duas letras (por exemplo: EUA).

UpdatePaymentInstrument

Atributo Tipo Description
UserId String O identificador do cliente. Este é um atributo obrigatório.
MerchantPaymentInstrumentId String O identificador do instrumento de pagamento. Estas informações são fornecidas pelo comerciante. Este é um atributo obrigatório.
PaymentInstrumenttype String O tipo de pagamento: Cartão de Crédito, PayPal, CH, SEPA, BACS, Mobilepayment, Giftcard, ou outro.
PaymentInstrumentcreationDate DateTime A data da primeira entrada do instrumento de pagamento no sistema do comerciante. O formato é ISO 8601.
PaymentInstrumentupdateDate DateTime A data da última atualização do instrumento de pagamento no sistema do comerciante. O formato é ISO 8601.
PaymentInstrumentState String O estado do instrumento de pagamento: Ativo, Bloquear ou Expirar.
Tipo de Cartão String Este atributo é usado apenas para pagamentos do tipo Cartão de Crédito .
Nome do Titular String O nome do cliente do instrumento de pagamento. Este atributo é usado apenas para pagamentos do tipo Cartão de Crédito .
COMPARTIMENTO String Este atributo é usado apenas para pagamentos do tipo Cartão de Crédito .
Data de validade String A data de expiração do instrumento de pagamento no sistema do comerciante. Este atributo é usado apenas para pagamentos do tipo Cartão de Crédito .
ÚltimoQuatroDígitos String Este atributo é usado apenas para pagamentos do tipo Cartão de Crédito .
Correio Eletrónico String O endereço de e-mail associado ao instrumento de pagamento. Este atributo é usado apenas para pagamentos do tipo PayPal .
BillingAgreementId String Este atributo é usado apenas para pagamentos do tipo PayPal .
PayerId String Este atributo é usado apenas para pagamentos do tipo PayPal .
Estatuto do Pagador String Um valor que indica se PayPal verificou o ordenante. Este atributo é usado apenas para pagamentos do tipo PayPal .
EndereçoStatus String Um valor que indica se PayPal verificou o endereço do ordenante. Este atributo é usado apenas para pagamentos do tipo PayPal .
IMEI String Este atributo é usado apenas para pagamentos do tipo Mobilepayment .
BillingAddressfirstName String O primeiro nome que foi fornecido para o endereço.
Endereço para faturamentosobrenomeNome String O sobrenome que foi fornecido para o endereço.
FaturaçãoEndereçoTelefoneNúmero String O número de telefone que foi fornecido para o endereço. O formato deve ser o código do país ou região seguido de um hífen (-) e, em seguida, o número de telefone (por exemplo: para os EUA, +1-1234567890).
Rua1 String A primeira linha que foi fornecida para o endereço.
Rua2 String A segunda linha que foi fornecida para o endereço. (Este valor pode estar em branco.)
Rua3 String Terceira linha que foi fornecida para o endereço. (Este valor pode estar em branco.)
Localidade String A cidade que foi fornecida para o endereço.
Distrito String O estado ou província que foi fornecido para o endereço.
Distrito String O distrito que foi fornecido para o endereço. (Este valor pode estar em branco.)
Código Postal String O código postal que foi fornecido para o endereço.
CountryCode String O código de país ou região fornecido para o endereço. O valor deve ser um código ISO de país ou região de duas letras (por exemplo: EUA).

Etiquetas

O esquema a seguir é usado na avaliação e proteção de experiências.

Atributo Tipo Description
TrackingId String O ID exclusivo para cada evento/registro.
MerchantLocalDate DateTime A data no fuso horário do comerciante. O formato é ISO 8601.
EventTimeStamp DateTime A data e hora do evento. O formato é ISO 8601. Para obter mais informações, consulte API de proteção contra fraude do Dynamics 365.
LabelObjectType String Este campo indica o tipo de etiqueta: Compra, Inscrição, Avaliação de fraude personalizada, Conta, Instrumento de pagamento ou E-mail.
LabelObjectId String Este é um campo identificador para o tipo de objeto: PurchaseId, SignupId, UserId, MerchantPaymentInstrumentId ou Email.
LabelSource String Este campo representa a origem do rótulo.
LabelState String Este campo indica o estado atual da etiqueta. Para obter mais informações, consulte API de proteção contra fraude do Dynamics 365.
LabelReasonCodes String Este campo indica os códigos de motivo associados a cada tipo de etiqueta. Para obter mais informações, consulte API de proteção contra fraude do Dynamics 365.
Processador String O nome do banco ou processador de pagamentos. Para obter mais informações, consulte API de proteção contra fraude do Dynamics 365.
EffectiveStartDate DateTime A data a partir da qual este rótulo produz efeitos. O formato é ISO 8601.
EffectiveEndDate DateTime A data final para este rótulo. O formato é ISO 8601.
Montante Duplo O valor que foi cobrado ao cliente. Estas informações são fornecidas pelo comerciante.
Moeda String A moeda da compra original como um código de moeda de três caracteres. (Por exemplo: USD, que está alinhado com o código de moeda OANDA). Estas informações são fornecidas pelo comerciante.

Atributos específicos da vertical

Atributo Vertical Tipo Description
Visão Geral da Viagem
Aluguer de CarroIncluído Viagens Boolean Um valor Verdadeiro/Falso que indica se um aluguer de automóvel está incluído.
AlojamentoIncluído Viagens Boolean Um valor Verdadeiro/Falso que indica se o alojamento está incluído.
Tipo de viagem Viagens String A categoria ou tipo de viagem.
IsRoundTrip Viagens Boolean Um valor Verdadeiro/Falso que indica se a viagem é ida e volta.
IsDiscountOffered Viagens Boolean Um valor Verdadeiro/Falso que indica se um desconto foi oferecido.
TravelDateTime Viagens DateTimeOffset A data e hora de início da viagem.
ReturnDateTime Viagens DateTimeOffset A data e hora de fim ou retorno da viagem.
FromCity Viagens String A cidade de onde o cliente está viajando.
FromState Viagens String O Estado de onde o cliente viaja.
FromCountryISO Viagens String O país ISO de onde o cliente está viajando.
FromZipCode Viagens String O código postal de onde o cliente está viajando.
ToCity Viagens String A cidade para onde o cliente está viajando.
ToState Viagens String O estado para onde o cliente está viajando.
ToCountryISO Viagens String O país ISO para onde o cliente está viajando.
ToZipCode Viagens String O código postal para onde o cliente está viajando.
DuraçãoViagem Viagens String Preterido. Não utilizar.
IsPackagedTour Viagens Boolean Um valor True/False que indica se este foi um tour empacotado.
Tipo de Reserva Viagens String O tipo de reserva.
WebUrl Viagens String O URL onde a viagem foi reservada.
IssueDateTime Viagens DateTimeOffset A data e hora em que os bilhetes foram emitidos.
FlightDetails Viagens Object Consulte a seção FlightDetails.
AlojamentoDetalhes Viagens Object Consulte a secção LodgingDetails.
Aluguer de CarroDetalhes Viagens Object Consulte a secção CarRentalDetails.
Agente de viagens Viagens Object Consulte a secção TravelAgent.
FlightDetails
Número do bilhete Viagens String O número único do bilhete.
PlaceOfIssue Viagens String O local onde o bilhete foi emitido.
IsRestrictedTicket Viagens Boolean Um valor True/False que indica se o ticket é restrito.
RecompensasOrVoucherAplicado Viagens Boolean Um valor Verdadeiro/Falso que indica se foram aplicadas recompensas ou vouchers à encomenda.
TotalRewardsAplicado Viagens int32 O total de recompensas que foram aplicadas à ordem.
Taxas totais Viagens decimal O total de taxas aplicadas à encomenda.
Contagem de Passageiros Viagens Int32 O número total de passageiros.
NúmerodeParadas Viagens Int32 O número de escalas ou escalas para o voo.
PurchaserProfileType Viagens String O perfil ou tipo de associação do cliente.
IsThirdParty Viagens Boolean Um valor Verdadeiro/Falso que indica se o pedido foi feito através de um site de terceiros.
IsPurchaserFrequentFlyer Viagens Boolean Um valor Verdadeiro/Falso que indica se o cliente é um passageiro frequente.
FlightSegments Viagens Object Consulte a seção FlightSegments.
Passageiros Viagens Object Consulte a secção Passageiros.
FlightSegments
Código da companhia aérea Viagens String O código da companhia aérea.
Nome da companhia aérea Viagens String O nome da companhia aérea.
SegmentSequence Viagens Int32 O número sequencial do trecho de voo em questão (por exemplo, 2 para o segundo trecho do voo)
TravelClass Viagens String A classe de assento ou cabine.
OperadoPor Viagens String A organização que opera o voo.
Número do voo Viagens String O número do voo.
FromAirportCode Viagens String O código do aeroporto de onde o voo está voando.
ToAirportCode Viagens String O código do aeroporto para onde o voo está voando.
PartidaDataHora Viagens DateTimeOffset A data e hora de partida.
ChegadaDataHora Viagens DateTimeOffset A data e hora de chegada.
FromAirportCity Viagens String A cidade do aeroporto de onde o cliente está viajando.
FromAirportState Viagens String O estado do aeroporto de onde o cliente está viajando.
FromAirportZipcode Viagens String O código postal do aeroporto de onde o cliente está viajando.
DeAeroportoPaísISO Viagens String O código ISO do país do aeroporto de onde o cliente está viajando.
ToAirportCity Viagens String A cidade do aeroporto para onde o cliente está viajando.
ToAirportState Viagens String O estado do aeroporto para onde o cliente está viajando.
ToAirportCEP Viagens String O código postal do aeroporto para onde o cliente está viajando.
ToAeroportoPaísISO Viagens String O país ISO do aeroporto para onde o cliente está viajando.
Passageiros
FirstName Viagens String O primeiro nome do passageiro.
LastName Viagens String O sobrenome do passageiro.
Aluguer de CarroDetalhes
PickupLocalização Viagens String O local de recolha do aluguer de automóveis.
PickupDateTime Viagens DateTimeOffset A data e hora de recolha do aluguer de automóveis.
DropOffLocalização Viagens String O local de entrega do aluguer de automóveis.
DropOffDateTime Viagens DateTimeOffset A data e hora de entrega do aluguer de automóveis
Programa de Descontos Viagens String O programa de descontos aplicava-se à encomenda de aluguer de automóveis.
Tipo de carro Viagens String O tipo ou categoria do carro.
IsPré-pago Viagens Boolean Um valor Verdadeiro/Falso que indica se o aluguer de automóvel foi pré-pago.
SeguroIncluído Viagens Boolean Um valor Verdadeiro/Falso que indica se o seguro foi incluído.
ContactEmail Viagens String O endereço de e-mail do locatário do carro.
Número de telefone de contato Viagens String O número de telefone do locatário do carro.
Endereço de Levantamento Viagens Object Consulte a secção Endereço.
DropOffAddress Viagens Object Consulte a secção Endereço.
Agente de viagens
Código da Agência Viagens String O código da agência de viagens.
Nome da Agência Viagens String O nome da agência de viagens.
Código do agente Viagens String O código do agente de viagens.
AgênciaLocalização Viagens Object Consulte a seção AgentAddress.
Endereço do agente
Rua1 Viagens String A primeira linha que foi fornecida para o endereço
Rua2 Viagens String A segunda linha que foi fornecida para o endereço. (Este valor pode estar em branco.)
Rua3 Viagens String A terceira linha que foi fornecida para o endereço. (Este valor pode estar em branco.)
City Viagens String A cidade que foi fornecida para o endereço.
Estado Viagens String O estado ou província que foi fornecido para o endereço.
Distrito Viagens String O distrito que foi fornecido para o endereço.
Código Postal Viagens String O código postal que foi fornecido para o endereço.
País Viagens 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).
AgênciaContactoTelefone Viagens String O número de telefone de contato da agência.
AgênciaContactoEmail Viagens String O endereço de e-mail de contato da agência.
AlojamentoDetalhes
Número do fólio Alojamento String O identificador único da propriedade de alojamento.
CheckInDate Alojamento DateTimeOffset A data de check-in para a estadia do alojamento.
Data de SaídaSaída Alojamento DateTimeOffset A data de check-out para a estadia do alojamento.
ReservaConfirmado Alojamento Boolean Um valor True/False que indica se a reserva foi confirmada.
MembershipDetails Alojamento String Detalhes adicionais sobre o status de associação do cliente.
Programa de Descontos Alojamento String O programa de descontos aplicava-se à ordem de alojamento.
Contagem de Adultos Alojamento Int32 O número de adultos incluídos na estadia.
Contagem de crianças Alojamento Int32 O número de crianças incluídas na estadia.
NoitesContagem Alojamento Int32 O número de noites incluídas na estadia.
Contagem de quartos Alojamento Int32 O número de quartos incluídos na estadia.
Tipo de cama Alojamento String O tipo de cama ou categoria.
Tipo de quarto Alojamento String O tipo ou categoria do quarto.
PagamentoDescrição Alojamento String Detalhes adicionais sobre o pagamento da hospedagem.
Instalações Alojamento Object Consulte a secção Facilidades.
Instalações
Nome Alojamento String O nome da instalação.
Type Alojamento String O tipo de instalação.
Número de telefone de contato Alojamento String O número de telefone usado para entrar em contato com o estabelecimento.
ContactEmail Alojamento String O endereço de e-mail usado para entrar em contato com a instalação.
DiáriaTarifa Alojamento decimal A tarifa diária do quarto para a instalação.
Moeda Alojamento String A moeda suportada pelo mecanismo.
DailyRoomTaxAmount Alojamento decimal O valor do imposto diário cobrado pela instalação.
Endereço Alojamento Object Consulte a secção Endereço.
Endereço
Rua1 Aluguer de Automóvel String A primeira linha que foi fornecida para o endereço
Rua2 Aluguer de Automóvel String A segunda linha que foi fornecida para o endereço. (Este valor pode estar em branco.)
Rua3 Aluguer de Automóvel String A terceira linha que foi fornecida para o endereço. (Este valor pode estar em branco.)
City Aluguer de Automóvel String A cidade que foi fornecida para o endereço.
Estado Aluguer de Automóvel String O estado ou província que foi fornecido para o endereço.
Distrito Aluguer de Automóvel String O distrito que foi fornecido para o endereço.
Código Postal Aluguer de Automóvel String O código postal que foi fornecido para o endereço.
País Aluguer de Automóvel 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).
CloudBusiness
ID Organização CloudBusiness String O identificador exclusivo para o serviço de nuvem ou organização.
CompanyName CloudBusiness String O nome do serviço de nuvem.
Tipo de Empresa CloudBusiness String O tipo de empresa na nuvem.
Dimensão da Empresa CloudBusiness Int32 O tamanho da empresa de nuvem.
EntityId CloudBusiness String O identificador exclusivo para a entidade legal sob a organização.
PrimaryContactFirstName CloudBusiness String O primeiro nome do contato principal da empresa.
PrimaryContactLastName CloudBusiness String O sobrenome do contato principal da empresa.
PrincipalContatoEmail CloudBusiness String O endereço de e-mail do contato principal da empresa.
PrincipalContactPhoneNumber CloudBusiness String O número de telefone do contato principal da empresa.
AssinaturaContagem CloudBusiness Int32 O número total de subscrições disponíveis.
Endereço da Empresa CloudBusiness Object Consulte a secção Endereço.

Transferir dados de exemplo

Você pode baixar nossos arquivos de dados de exemplo para explorar opções antes de usar seus próprios dados internos.

Exemplo de dados personalizados

O exemplo a seguir mostra como usar APIs de compra com um objeto de dados personalizado na Proteção contra fraude.

{ 
"CustomData": { 
"EngagementDuration": 120.4, 
"GamerScore": 10, 
"InApp": true, 
"MiscSampleA": "abc" 
} 
}