A venda direta combina a Autorização e a Captura em uma mesma chamada. Ao usar a requisição de Venda Direta você estará fazendo uma autorização no cartão do cliente e imediatamente executando uma captura total do valor. O retorno da maxiPago! já virá com o status final da transação.


Categorização de transações card-on-file

Desde outubro de 2022, devido a mudanças regulatórias de bandeiras, as transações card-on-file da bandeira Mastercard passarão a ser categorizadas em 12 tipos de categorias CIT (Iniciadas pelo portador do cartão – Card Holder) e MIT (Iniciadas pelo estabelecimento – Merchant). Desde 1 de junho de 2023, a bandeira passou a monitorar o envio do campo, fique atento pois podem ocorrer ações de compliance.

O crescimento contínuo do comércio eletrônico, juntamente com o aumento dos tipos de transação, exige a necessidade de entender a intenção do consumidor. A introdução do indicador CIT ou MIT fornece transparência permitindo o uso para:

  • Lógica de autorização do emissor
  • Detecção de fraude
  • Gestão de disputas

Por isso, é necessário realizar ajustes em sua integração com o e.Rede para envio do campo chamado “credentialId”, que fará parte do grupo “transactionCredentials”. Desse modo, quando storageCard for igual a 1 ou 2, indicando que o cartão está sendo ou já foi armazenado, será obrigatório indicar em qual categoria a transação card-on-file (credencial armazenada) está enquadrada.

O envio também deve ser feito em transações Zero Dollar que pretendem armazenar o cartão.

O envio deste campo passou a ser obrigatório para a operação Mastercard desde 01 de junho de 2023, e a partir de 01 de junho de 2024, a bandeira Mastercard poderá aplicar penalidades em caso de não conformidade dos estabelecimentos, referente ao período fora da norma. Entre os benefícios do envio do campo, está a capacidade de apoiar a bandeira e o emissor na análise de suas transações, o que pode ajudar na conversão. Os outros campos já utilizados atualmente para finalidades semelhantes como storageCard, subscription e installments, precisam continuar a ser populados.

Para o envio correto do campo Storage Card e Credential Id nas Transações 3DS Rede é necessário seguir tabela de parâmetros contida na Documentação do e.Rede:

Tabela de Categorização de transações card-on-file Rede

Venda Direta – URLs Para Envio dos Dados

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

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

Venda Direta – 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>Sandbox_teste_1</referenceNum>
            <fraudCheck>N</fraudCheck>
            <ipAddress>192.168.0.10</ipAddress>
            <customerIdExt>120.071.510-14</customerIdExt>
            <billing>
                <name>Cliente Gateway</name>
                <address>R. Volkswagen 1</address>
                <address2>11º Andar</address2>
                <district>Jabaquara</district>
                <city>Sao Paulo</city>
                <state>SP</state>
                <postalcode>04344902</postalcode>
                <country>BR</country>
                <phone>1140044828</phone>
                <email>clientegateway@clientegateway.com.br</email>
                <companyName>maxiPago!</companyName>
            </billing>
            <shipping>
                <name>Cliente Gateway</name>
                <address>R. Volkswagen 1</address>
                <address2>11º Andar</address2>
                <district>Jabaquara</district>
                <city>Sao Paulo</city>
                <state>SP</state>
                <postalcode>04344902</postalcode>
                <country>BR</country>
                <phone>1140044828</phone>
                <email>clientegateway@clientegateway.com.br</email>
            </shipping>
            <transactionDetail>
                <payType>
                    <creditCard>
                        <number>5510156038012409</number>
                        <expMonth>12</expMonth>
                        <expYear>2028</expYear>
                        <cvvNumber>100</cvvNumber>
                        <storageCard>1</storageCard>
                        <credentialId>03</credentialId>
                    </creditCard>
                </payType>
            </transactionDetail>
            <payment>
                <chargeTotal>100.00</chargeTotal>
                <currencyCode>BRL</currencyCode>
                <creditInstallment>
                    <numberOfInstallments>2</numberOfInstallments>
                    <chargeInterest>N</chargeInterest>
                </creditInstallment>
            </payment>
        </sale>
    </order>
</transaction-request>

Venda Direta – Exemplo de Retorno em Caso de Sucesso

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
    <authCode>123456</authCode>
    <orderID>0A0104A3:01621AEB218F:EC41:3905FF2F</orderID>
    <referenceNum>Sandbox_teste_1</referenceNum>
    <transactionID>1791929</transactionID>
    <transactionTimestamp>1520870039</transactionTimestamp>
    <responseCode>0</responseCode>
    <responseMessage>CAPTURED</responseMessage>
    <avsResponseCode>YYY</avsResponseCode>
    <cvvResponseCode>M</cvvResponseCode>
    <processorCode>A</processorCode>
    <processorMessage>APPROVED</processorMessage>
    <processorName>SIMULATOR</processorName>
    <creditCardBin>551015</creditCardBin>
    <creditCardLast4>2409</creditCardLast4>
    <errorMessage/>
    <processorTransactionID>813348</processorTransactionID>
    <processorReferenceNumber>970280</processorReferenceNumber>
    <creditCardCountry>US</creditCardCountry>
    <creditCardScheme>Mastercard</creditCardScheme>
    <brandcode>00</brandcode>
    <brandmessage>Success.</brandmessage>
    <brandtransactionid>021534</brandtransactionid>
</transaction-response>

Venda Direta – Exemplo de Retorno em de Erro

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
    <authCode/>
    <orderID/>
    <referenceNum/>
    <transactionID/>
    <transactionTimestamp>1474901898531</transactionTimestamp>
    <responseCode>1024</responseCode>
    <responseMessage>INVALID REQUEST</responseMessage>
    <avsResponseCode/>
    <cvvResponseCode/>
    <processorCode/>
    <processorMessage/>
    <errorMessage>Credit Card  Number is not a valid credit card number.</errorMessage>
    <creditCardScheme>Visa</creditCardScheme>
</transaction-response>

Venda Direta – Tabela de Parâmetros

Liberação dos IP´s maxiPago!

Algumas empresas necessitam dos IP´s de saída da maxiPago!. Recomendamos a verificação dessa permissão utilizando os IPs abaixo:

  • 52.207.83.230
  • 54.237.160.163