Kount

iFrame para análise do Browser

Uma peça chave do fraudControl! é a análise do browser do comprador. Com esta informação é possível traçar uma “impressão digital” da máquina do comprador e avaliar a probabilidade daquela transação ser uma fraude onde, por exemplo, o computador está em um fuso horário da Rússia, mas o endereço de entrega é no RJ.

Segue abaixo o fluxo geral dos dados de transações envolvendo o antifraude:

Para permitir a análise, o Lojista precisa incluir na sua página de check-out um iFrame, com os campos abaixo:

O detalhamento do fluxo do cálculo do h está descrito no seguinte diagrama:

O iFrame fica, então, da seguinte forma:

<iframe width=”1” height=”1” frameborder=”0” 
src=”https://testauthentication.maxipago.net/redirection_service/logo?m=100&s=ORD12345678&h=fe220a160c7fa6f7fc104185f8663e45”>
</iframe>

Kount – Requisições de Fraude

As chamadas para o fraudControl! já estão incluídas em nossa API. Portanto, não há a necessidade de métodos adicionais. Se o serviço estiver contratado, basta enviar uma transação para que ela seja verificada.

Para escolher quais transações serão passadas pelo serviço e quais serão processadas sem checagem de fraude, basta incluir o campo fraudCheck na requisição com os valores “Y” ou “N”. Ou se preferir solicite que todas as transações de cartão de crédito sejam enviadas para o fraudControl!

Kount – URL para envio dos dados

SANDBOX: https://testapi.maxipago.net/UniversalAPI/postXML

PRODUÇÃO: https://api.maxipago.net/UniversalAPI/postXML

Kount – Exemplo de chamada de autorização

<?xml version="1.0" encoding="UTF-8"?>
<transaction-request>
    <version>3.1.1.15</version>
    <verification>
        <merchantId>store-id</merchantId>
        <merchantKey>secret-key</merchantKey>
    </verification>
    <order>
        <auth>
            <processorID>1</processorID>
            <referenceNum>K20151109-03</referenceNum>
            <fraudCheck>Y</fraudCheck>
            <ipAddress>123.123.123.123</ipAddress>
            <billing>
                <id>2546582</id>
                <name>Fulano de Tal</name>
                <address>Av. Republica Livre, 230</address>
                <address2>16 Andar</address2>
                <district>Centro</district>
                <city>Sao Paulo</city>
                <state>SP</state>
                <postalcode>08021310</postalcode>
                <country>BR</country>
                <email>fulanodetal@email.com</email>
                <type>Individual</type>
                <gender>M</gender>
                <birthDate>1982-03-08</birthDate>
                <phones>
                    <phone>
                        <phoneType>Commercial</phoneType>
                        <phoneCountryCode>55</phoneCountryCode>
                        <phoneAreaCode>11</phoneAreaCode>
                        <phoneNumber>55554444</phoneNumber>
                        <phoneExtension>1234</phoneExtension>
                    </phone>
                    <phone>
                        <phoneType>Residential</phoneType>
                        <phoneCountryCode>55</phoneCountryCode>
                        <phoneAreaCode>11</phoneAreaCode>
                        <phoneNumber>55554444</phoneNumber>
                        <phoneExtension>1234</phoneExtension>
                    </phone>
                </phones>
                <documents>
                    <document>
                        <documentType>CPF</documentType>
                        <documentValue>259228370-60</documentValue>
                    </document>
                    <document>
                        <documentType>RG</documentType>
                        <documentValue>12546785-2Y</documentValue>
                    </document>
                </documents>
            </billing>
            <shipping>
                <id>OFFICE</id>
                <name>Fulana de Tal</name>
                <address>Rua de Teste, 123</address>
                <address2>16 Andar</address2>
                <district>Centro</district>
                <city>Sao Paulo</city>
                <state>SP</state>
                <postalcode>12345000</postalcode>
                <country>BR</country>
                <type>Individual</type>
                <gender>F</gender>
                <birthDate>1982-03-08</birthDate>
                <phones>
                    <phone>
                        <phoneType>Commercial</phoneType>
                        <phoneCountryCode>55</phoneCountryCode>
                        <phoneAreaCode>11</phoneAreaCode>
                        <phoneNumber>55554444</phoneNumber>
                        <phoneExtension>1234</phoneExtension>
                    </phone>
                    <phone>
                        <phoneType>Residential</phoneType>
                        <phoneCountryCode>55</phoneCountryCode>
                        <phoneAreaCode>11</phoneAreaCode>
                        <phoneNumber>55554444</phoneNumber>
                        <phoneExtension>1234</phoneExtension>
                    </phone>
                </phones>
                <documents>
                    <document>
                        <documentType>CPF</documentType>
                        <documentValue>128856789-80</documentValue>
                    </document>
                    <document>
                        <documentType>RG</documentType>
                        <documentValue>123456789-60Z</documentValue>
                    </document>
                </documents>
            </shipping>
            <fraudDetails>
                <fraudProcessorID>99</fraudProcessorID>
                <captureOnLowRisk>N</captureOnLowRisk>
                <voidOnHighRisk>N</voidOnHighRisk>
                <websiteId>MXP_DEV</websiteId>
                <fraudToken>q1234564987981alksf43549138</fraudToken>
            </fraudDetails>
            <transactionDetail>
                <payType>
                    <creditCard>
                        <number>4539330315585581</number>
                        <expMonth>12</expMonth>
                        <expYear>2016</expYear>
                        <cvvNumber>082</cvvNumber>
                    </creditCard>
                </payType>
            </transactionDetail>
            <payment>
                <chargeTotal>149.99</chargeTotal>
                <shippingTotal>10.00</shippingTotal>
            </payment>
            <itemList itemCount="3">
                <item>
                    <itemIndex>1</itemIndex>
                    <itemProductCode>Product de Teste Um</itemProductCode>
                    <itemDescription>Certificacao de Integracao 01</itemDescription>
                    <itemQuantity>2</itemQuantity>
                    <itemTotalAmount>30.00</itemTotalAmount>
                    <itemUnitCost>15.00</itemUnitCost>
                </item>
                <item>
                    <itemIndex>2</itemIndex>
                    <itemProductCode>Produto de Teste Dois</itemProductCode>
                    <itemDescription>Certificacao de Integracao 02</itemDescription>
                    <itemQuantity>2</itemQuantity>
                    <itemTotalAmount>10.00</itemTotalAmount>
                    <itemUnitCost>5.00</itemUnitCost>
                </item>
                <item>
                    <itemIndex>3</itemIndex>
                    <itemProductCode>Produto de Teste Tres</itemProductCode>
                    <itemDescription>Certificacao de Integracao 03</itemDescription>
                    <itemQuantity>3</itemQuantity>
                    <itemTotalAmount>99.99</itemTotalAmount>
                    <itemUnitCost>33.33</itemUnitCost>
                </item>
            </itemList>
        </auth>
    </order>
</transaction-request>

Kount – Exemplo de retorno da chamada de autorização com sucesso

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
        <authCode>123456</authCode>
        <orderID>0A01159A:0157D30291E8:ABC3:57D3E40F</orderID>
        <referenceNum>2016</referenceNum>
        <transactionID>160701373</transactionID>
        <transactionTimestamp>1476713985</transactionTimestamp>
        <responseCode>0</responseCode>
        <responseMessage>AUTHORIZED</responseMessage>
        <avsResponseCode>YYY</avsResponseCode>
        <cvvResponseCode>M</cvvResponseCode>
        <processorCode>A</processorCode>
        <processorMessage>APPROVED</processorMessage>
        <errorMessage/>
        <processorTransactionID>P4630LMLSK0K</processorTransactionID>
        <processorReferenceNumber>135792468</processorReferenceNumber>
        <fraudScore>38</fraudScore>
        <creditCardCountry>US</creditCardCountry>
        <creditCardScheme>Visa</creditCardScheme>
</transaction-response>

Kount – Exemplo de retorno da chamada de autorização com erro

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
        <authCode>123456</authCode>
        <orderID>0A01159A:0157D2F0FF0E:3551:338D9133</orderID>
        <referenceNum>K20151109-03</referenceNum>
        <transactionID>160700938</transactionID>
        <transactionTimestamp>1476712834</transactionTimestamp>
        <responseCode>1024</responseCode>
        <responseMessage>INVALID REQUEST</responseMessage>
        <avsResponseCode>YYY</avsResponseCode>
        <cvvResponseCode>M</cvvResponseCode>
        <processorCode>A</processorCode>
        <processorMessage>APPROVED</processorMessage>
        <errorMessage>Request is invalid and can not be processed.</errorMessage>
        <processorReferenceNumber>135792468</processorReferenceNumber>
        <creditCardCountry>US</creditCardCountry>
        <creditCardScheme>Visa</creditCardScheme>
</transaction-response>

Kount – Tabela de parâmetros