Comunidade de Desenvolvedores maxiPago!

Venda Direta

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.

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>Nome Comprador</name>
                <address>Avenida Paulista</address>
                <address2>123, 11º Andar</address2>
                <district>Bela Vista</district>
                <city>Sao Paulo</city>
                <state>SP</state>
                <postalcode>01311000</postalcode>
                <country>BR</country>
                <phone>1122334455</phone>
                <email>billing@maxipago.com</email>
                <companyName>maxiPago!</companyName>
            </billing>
            <shipping>
                <name>Nome Recebedor</name>
                <address>Avenida Paulista</address>
                <address2>123, 11º Andar</address2>
                <district>Bela Vista</district>
                <city>Sao Paulo</city>
                <state>SP</state>
                <postalcode>01311000</postalcode>
                <country>BR</country>
                <phone>1122334455</phone>
                <email>shipping@maxipago.com</email>
            </shipping>
            <transactionDetail>
                <payType>
                    <creditCard>
                        <number>5510156038012409</number>
                        <expMonth>12</expMonth>
                        <expYear>2028</expYear>
                        <cvvNumber>100</cvvNumber>
                    </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>
</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

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 estabelecimentoEste campo aceita apenas valores alfanuméricos e deve ser único.

processorID

Sim

2

Código da adquirente que irá processar a transação: Simulador de teste = 1 Rede = 2 GetNet = 3 Cielo = 4 e.REDE= 5 Elavon = 6 ChasePaymentech = 8 Stone = 9

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

CPF do comprador

customerIdExt

Sim

16

Endereço de IP do comprador

billing/name
shipping/name

Sim

64

Nome do cliente

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/distric
shipping/distric

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 (UF)).

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/email
shipping/email

Sim

128

Utilização obrigatória de “@”.

billing/country
shipping/country

Sim

64

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

companyName

Sim

64

Biling: Nome da empresa vendedora.

number

Sim

19

Número do cartão de crédito do cliente

expMonth

Sim

2

Mês de vencimento do cartão com 2 dígitos.

Exemplo: Janeiro = 01

expYear

Sim

4

Ano de vencimento do cartão com 4 dígitos

cvvNumber

Sim

3

Código de segurança do cartão.

Obs.: embora o campo não seja obrigatório em nosso sistema as adquirentes podem bloquear transações caso este campo esteja vazio.

Por favor, cheque suas permissões na Adquirente.

chargeTotal

Sim

14.2

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

currencyCode

Não

3

Código da moeda da transação no formato ISO 4217.

numberOfInstallments

Não

2

Número de parcelas da transação. Para transações à vista não enviar / enviar nulo.

chargeInterest

Não

1

Define se o parcelamento é do tipo loja ou cartão.

Para transações à vista não enviar / enviar nulo.

N = padrão parcelamento loja (sem juros)

Y = parcelamento cartão (com juros).