Comunidade de Desenvolvedores maxiPago!

3DS Cartão de Débito e Crédito

Cartão de Débito e Cartão de Crédito

 

– Compra autenticada pelo banco emissor.

– Permite ao lojista habilitar a função cartão de débito como meio de pagamento.

– Mais segurança para suas transações, cartão de débito e crédito.

– Elimina o chargeback para o lojista (liability shift).

– Cartão de Débito: liquidação D+2, MDR mais barato e sem chargeback.

 

Atualmente, somente as bandeiras Mastercard e Visa possuem esse serviço ativo, identificados como Mastercard SecureCode e Verified by Visa, respectivamente.

A autenticação 3DS é efetuada através da validação de dados que apenas o portador do cartão e o banco possuem, como por exemplo, senha do cartão, data de nascimento, código de segurança, token do banco. Em caso de sucesso da autenticação, o emissor assume o risco da transação.

Importante: autenticação 3DS é obrigatória para todas as transações efetuadas com cartões de débito. Para os cartões de crédito, sua utilização é opcional.

 

Observação: nos casos em que há o chamado “Desafio”, o retorno da URL do banco, pode pode ser aberta em lightbox com as dimensões de até 400×400. Esse valor muda de acordo com o banco, por isso, recomendamos considerar o tamanho máximo.

 

Fluxo Transação 3DS

 

3Ds Cartão de crédito e débito – URLs Para Envio dos Dados

 

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

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

 

3DS com Cartão de Débito (Sale) – Exemplo de Requisição

<?xml version="1.0" encoding="UTF-8"?>
<transaction-request>
    <version>3.1.1.15</version>
    <verification>
        <merchantId>store-id</merchantId>
        <merchantKey>store-key</merchantKey>
    </verification>
    <order>
        <sale>
            <processorID>1</processorID>
            <referenceNum>TestTransaction123</referenceNum>
            <customerIdExt>25922837060</customerIdExt>
            <fraudCheck>N</fraudCheck>
            <ipAddress>123.123.123.123</ipAddress>
            <invoiceNumber>TESTE123</invoiceNumber>
            <userAgent>MOZILLA/5.0 (WINDOWS; U; WINDOWS NT 6.0; EN-US) APPLEWEBKIT/534.16 (KHTML, LIKE GECKO) CHROME/10.0.648.133 SAFARI/534.16</userAgent>
            <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>
                <companyName>BillingCompany</companyName>
                <type>Individual</type>
                <gender>M</gender>
                <birthDate>1982-03-08</birthDate>
                <phones>
                    <phone>
                        <phoneType>Commercial</phoneType>
                        <phoneCountryCode>55</phoneCountryCode>
                        <phoneAreaCode>11</phoneAreaCode>
                        <phoneNumber>32890900</phoneNumber>
                        <phoneExtension>123</phoneExtension>
                    </phone>
                </phones>
                <documents>
                    <document>
                        <documentType>CPF</documentType>
                        <documentValue>25922837060</documentValue>
                    </document>
                </documents>
            </billing>
            <shipping>
                <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>
                <phone>1132890900</phone>
                <email>billing@maxipago.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>32890900</phoneNumber>
                        <phoneExtension>123</phoneExtension>
                    </phone>
                </phones>
                <documents>
                    <document>
                        <documentType>CPF</documentType>
                        <documentValue>25922837060</documentValue>
                    </document>
                </documents>
            </shipping>
            <authentication>
                <mpiProcessorID>41</mpiProcessorID>
                <onFailure>decline</onFailure>
            </authentication>
            <transactionDetail>
                <payType>
                    <debitCard>
                        <number>4000000000000002</number>
                        <expMonth>07</expMonth>
                        <expYear>2020</expYear>
                        <cvvNumber>268</cvvNumber>
                    </debitCard>
                </payType>
            </transactionDetail>
            <payment>
                <chargeTotal>10.00</chargeTotal>
                <softDescriptor>ORDER12313</softDescriptor>
                <iataFee>1.00</iataFee>
                <currencyCode>BRL</currencyCode>
            </payment>
            <itemList>
                <item>
                    <itemIndex>1</itemIndex>
                    <itemProductCode>a123456</itemProductCode>
                    <itemDescription>Produto de teste</itemDescription>
                    <itemQuantity>1</itemQuantity>
                    <itemTotalAmount>10</itemTotalAmount>
                    <itemUnitCost>10.00</itemUnitCost>
                </item>
            </itemList>
        </sale>
    </order>
</transaction-request>

 

 

3DS Cartão de Crédito (Auth) – Exemplo de Requisição

<?xml version="1.0" encoding="UTF-8"?>
<transaction-request>
    <version>3.1.1.15</version>
    <verification>
        <merchantId>store-id</merchantId>
        <merchantKey>store-key</merchantKey>
    </verification>
    <order>
        <auth>
            <processorID>1</processorID>
            <referenceNum>TestTransaction123</referenceNum>
            <customerIdExt>25922837060</customerIdExt>
            <fraudCheck>N</fraudCheck>
            <ipAddress>123.123.123.123</ipAddress>
            <invoiceNumber>TESTE123</invoiceNumber>
            <userAgent>MOZILLA/5.0 (WINDOWS; U; WINDOWS NT 6.0; EN-US) APPLEWEBKIT/534.16 (KHTML, LIKE GECKO) CHROME/10.0.648.133 SAFARI/534.16</userAgent>
            <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>
                <companyName>BillingCompany</companyName>
                <type>Individual</type>
                <gender>M</gender>
                <birthDate>1982-03-08</birthDate>
                <phones>
                    <phone>
                        <phoneType>Commercial</phoneType>
                        <phoneCountryCode>55</phoneCountryCode>
                        <phoneAreaCode>11</phoneAreaCode>
                        <phoneNumber>32890900</phoneNumber>
                        <phoneExtension>123</phoneExtension>
                    </phone>
                </phones>
                <documents>
                    <document>
                        <documentType>CPF</documentType>
                        <documentValue>25922837060</documentValue>
                    </document>
                </documents>
            </billing>
            <shipping>
                <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>
                <phone>1132890900</phone>
                <email>billing@maxipago.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>32890900</phoneNumber>
                        <phoneExtension>123</phoneExtension>
                    </phone>
                </phones>
                <documents>
                    <document>
                        <documentType>CPF</documentType>
                        <documentValue>25922837060</documentValue>
                    </document>
                </documents>
            </shipping>
            <authentication>
                <mpiProcessorID>41</mpiProcessorID>
                <onFailure>decline</onFailure>
            </authentication>
            <transactionDetail>
                <payType>
                    <creditCard>
                        <number>4000000000000002</number>
                        <expMonth>07</expMonth>
                        <expYear>2020</expYear>
                        <cvvNumber>268</cvvNumber>
                    </creditCard>
                </payType>
            </transactionDetail>
            <payment>
                <chargeTotal>10.00</chargeTotal>
                <softDescriptor>ORDER12313</softDescriptor>
                <iataFee>1.00</iataFee>
                <currencyCode>BRL</currencyCode>
                <creditInstallment>
                    <numberOfInstallments>2</numberOfInstallments>
                    <chargeInterest>N</chargeInterest>
                </creditInstallment>
            </payment>
            <itemList>
                <item>
                    <itemIndex>1</itemIndex>
                    <itemProductCode>a123456</itemProductCode>
                    <itemDescription>Produto de teste</itemDescription>
                    <itemQuantity>1</itemQuantity>
                    <itemTotalAmount>10</itemTotalAmount>
                    <itemUnitCost>10.00</itemUnitCost>
                </item>
            </itemList>
        </auth>
    </order>
</transaction-request>

 

 

 

3DS – Exemplo de Retorno em Caso de Sucesso

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
<authCode/>
<orderID>0A01158A:015E0F1F5A4C:7129:371FAEDD</orderID>
<referenceNum>TestTransaction123</referenceNum>
<transactionID>198258526</transactionID>
<transactionTimestamp>1503492266</transactionTimestamp>
<responseCode>0</responseCode>
<responseMessage>ENROLLED</responseMessage>
<avsResponseCode/>
<cvvResponseCode/>
<processorCode>Y</processorCode>
<processorMessage>ENROLLED</processorMessage>
<errorMessage/>
<processorTransactionID>TID198258526</processorTransactionID>
<processorReferenceNumber>REF198258526</processorReferenceNumber>
<authenticationURL>https://authentication.maxipago.net/redirection_service/auth?ref=zKsqpGQTDwlrvVwqJ%2F%2BPZnuyk8K7SihbAi2ySzLG17qHxGHzV%2BSXzP9xGVVeaZsRBtdobOeB5v6x%0AMyiYl%2BT3EDO8jKgUPdw6</authenticationURL>
<creditCardScheme>Visa</creditCardScheme>
</transaction-response>

 

 

 

3DS – Exemplo de Retorno em Caso de Erro

 
<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
    <authCode/>
    <orderID/>
    <referenceNum/>
    <transactionID/>
    <transactionTimestamp>1503492913183</transactionTimestamp>
    <responseCode>1025</responseCode>
    <responseMessage>INVALID MERCHANT</responseMessage>
    <avsResponseCode/>
    <cvvResponseCode/>
    <processorCode/>
    <processorMessage/>
    <errorMessage>MerchantID is not authorized to run payments of type Unknown Payment Type</errorMessage>
</transaction-response>

 

Parâmetros Retornados ao Término do Pagamento

 

Ao término do processo de pagamento, será realizado um post para a URL de sucesso ou erro com os parâmetros abaixo:

 

hp_processormsg: APPROVED 
hp_saddr:  
hp_customer_token:  
hp_amount: 40 
hp_refnum: Order-001 
hp_saddr2:  
hp_avsresponse: YYY 
hp_errormsg:  
hp_signature_response: 253bbd899f385a853cba154b7156e3d9 
ip: 127.0.0.1 
hp_scity:  
hp_time: 12/19/17 09:29:54 AM 
hp_scountry:  
hp_sstate:  
hp_creditcardscheme: Visa 
hp_payment_token:  
hp_processorrefno: 1031785 
hp_processorcode: A 
hp_processortxnid: 786576 
hp_authenticated: Y 
hp_transid: 1758390 
hp_authcode: 123456 
hp_orderid: 0A0104A3:01606FD21030:7236:4D710860 
hp_szip:  
hp_cvvresponse: M 
hp_responsemsg: CAPTURED 
hp_responsecode: 0

 

3DS – Tabela de parâmetros

 

Nome

Obrigatório

Tamanho

Descrição

version

Sim

11

Versão da API

merchantId

Sim

20

Id de Loja que identifica o estabelecimento

merchantKey

Sim

80

Chave associada ao ID da loja

referenceNum

Sim

128

Identificador do pedido no estabelecimento
Este campo aceita apenas valores alfanuméricos e deve ser único.

processorID

Sim

2

Código da Adquirente que irá processar a transação

customerIdExt

Sim

64

CPF do Consumidor

fraudCheck

Não

1

Flag para enviar transação para verificação de fraude. Se deixado em branco a transação será verificada.

 

Y ou vazio/nulo = checar

N = não checar

 

Este campo só funciona para clientes que possuem o serviço de antifraude contratado.

ipAddress

Não

16

Endereço de IP do comprador

invoiceNumber

Sim

100

Número da invoice do pedido.

userAgent

Sim

100

Informações no navegador com comprador

billing/id
shipping/id

Sim

50

ID do consumidor na base do lojista

billing/name
shipping/name

Sim

64

Nome do cliente (somente alfabético)

billing/address
shipping/address

Sim

128

Logradouro de cobrança da transação (sem acentos e caracteres especiais)

billing/address2
shipping/address2

Não

128

Complemento do Logradouro de cobrança da transação (sem acentos e caracteres especiais)

billing/district
shipping/district

Sim

64

Bairro (sem acentos e caracteres especiais)

billing/city
shipping/city

Sim

64

Cidade (sem acentos e caracteres especiais)

billing/state
shipping/state

Sim

32

Estado (enviado com 2 dígitos)

billing/postalcode
shipping/postalcode

Sim

16

CEP de Cobrança

billing/country
shipping/country

Sim

64

País (Abreviação de 2 dígitos)

billing/companyName

Não

64

Nome da empresa

billing/email
shipping/email

Sim

128

Utilização obrigatória de “@”

billing/phone
shipping/phone

Sim

16

Telefone

billing/type
shipping/type

Sim

50

Use “Individual” para CPF e “Legal entity” para CNPJ

billing/gender
shipping/gender

Sim

1

Sexo (“M” ou “F)

billing/birthDate
shipping/birthDate

Sim

12

Data de nascimento (AAAA-MM-DD)

phone/phoneType

Sim

50

Utilize um dos dados abaixo:

– Residential

– Commercial

– Mobile

– Fax

– Undefined

– Message

– Billing

phone/phoneCountryCode

Não

4

DDI do número de telefone

phone/phoneAreaCode

Sim

8

DDD do número de telefone

phone/phoneNumber

Sim

16

Número do telefone

phone/phoneExtension

Não

50

Ramal

document/documentType

Sim

50

Tipo de Documento. Utilize a lista abaixo:

CPF

RG

CNPJ

StateRegistration (não aplicado ao BR)

MunicipalRegistration (não aplicado ao BR)

Passport

CTPS (Carteira de Trabalho – número PIS)

VoterDocument (Título de Eleitor)

document/documentValue

Sim

50

Número do documento

mpiProcessorId

Sim

2

Código de processamento do MPI

onFailure

Sim

50

Ação ser realizada caso o cartão não possua o serviço habilitado.

decline = para declinar.

continue = para processar como transação de cartão de crédito convencional.

chargeTotal

Sim

14.2

Valor do pedido
Os decimais devem ser separados por ponto (“.”)

shippingTotal

Não

14.2

Valor do frete que será cobrado.
Os decimais devem ser separados por ponto (“.”)

itemIndex

Sim

1

Itens: Enumerador do item de 1 a n

itemProductCode

Não

50

Itens: Categoria do produto; Alfanumérico 
Ex: Acessórios de cozinha

itemDescription

Sim

100

Itens: Descrição do Item; Alfanumérico
Ex:  Facas Ginsu

itemQuantity

Sim

10

Itens: Quantidade deste item

itemTotalAmount

Sim

14.2

Valor dos Itens.
Os decimais devem ser separados por ponto (“.”)

itemUnitCost

Sim

14.2

Valor unitário do Item.
Os decimais devem ser separados por ponto (“.”)