3DS Cartão de Débito e Crédito
Table of Contents
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.
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 |
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 |
Sim |
50 |
ID do consumidor na base do lojista |
billing/name |
Sim |
64 |
Nome do cliente (somente alfabético) |
billing/address |
Sim |
128 |
Logradouro de cobrança da transação (sem acentos e caracteres especiais) |
billing/address2 |
Não |
128 |
Complemento do Logradouro de cobrança da transação (sem acentos e caracteres especiais) |
billing/district |
Sim |
64 |
Bairro (sem acentos e caracteres especiais) |
billing/city |
Sim |
64 |
Cidade (sem acentos e caracteres especiais) |
billing/state |
Sim |
32 |
Estado (enviado com 2 dígitos) |
billing/postalcode |
Sim |
16 |
CEP de Cobrança |
billing/country |
Sim |
64 |
País (Abreviação de 2 dígitos) |
billing/companyName |
Não |
64 |
Nome da empresa |
billing/email |
Sim |
128 |
Utilização obrigatória de “@” |
billing/phone |
Sim |
16 |
Telefone |
billing/type |
Sim |
50 |
Use “Individual” para CPF e “Legal entity” para CNPJ |
billing/gender |
Sim |
1 |
Sexo (“M” ou “F) |
billing/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 |
shippingTotal |
Não |
14.2 |
Valor do frete que será cobrado. |
itemIndex |
Sim |
1 |
Itens: Enumerador do item de 1 a n |
itemProductCode |
Não |
50 |
Itens: Categoria do produto; Alfanumérico |
itemDescription |
Sim |
100 |
Itens: Descrição do Item; Alfanumérico |
itemQuantity |
Sim |
10 |
Itens: Quantidade deste item |
itemTotalAmount |
Sim |
14.2 |
Valor dos Itens. |
itemUnitCost |
Sim |
14.2 |
Valor unitário do Item. |