Dados do Comprador

 

Apesar destes dados serem opcionais recomendamos enviar ao menos o nome do portador do cartão, para facilitar a referência ao pedido. Caso utilize a ferramenta antifraude, estes dados são obrigatórios.

Os campos devem ser enviados na mesma chamada da Autorização, Venda Direta, Recorrência ou Boleto.

A maxiPago! permite que você nos envie os dados de cobrança (<billing/>) e de entrega (<shipping/>) do seu cliente final.

 

Dados do Comprador – URLs Para Envio dos Dados

 

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

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

 

Dados do Comprador – 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>secret-key</merchantKey>
        </verification>
        <order>
                <sale>
                        <processorID>1</processorID>
                        <referenceNum>1234567890</referenceNum>
                        <billing>
                                <name>Fulano de Tal</name>
                                <address>Av. República do Chile, 230</address>
                                <address2>16 Andar</address2>
                                <city>Rio de Janeiro</city>
                                <state>RJ</state>
                                <postalcode>20031170</postalcode>
                                <country>BR</country>
                                <phone>2140099400</phone>
                                <email>fulanodetal@email.com</email>
                                <companyName>Empresa XPTO</companyName>
                        </billing>
                        <shipping>
                                <name>Ciclano de Tal</name>
                                <address>Av. Prestes Maia, 737</address>
                                <address2>20 Andar</address2>
                                <city>São Paulo</city>
                                <state>SP</state>
                                <postalcode>01031001</postalcode>
                                <country>BR</country>
                                <phone>1121737900</phone>
                                <email>ciclanodetal@email.com</email>
                        </shipping>
                        <transactionDetail>
                                <payType>
                                        <creditCard>
                                                <number>4111111111111111</number>
                                                <expMonth>12</expMonth>
                                                <expYear>2020</expYear>
                                                <cvvNumber>999</cvvNumber>
                                        </creditCard>
                                </payType>
                        </transactionDetail>
                        <payment>
                                <currencyCode>BRL</currencyCode>
                                <chargeTotal>20.00</chargeTotal>
                                <softDescriptor>teste</softDescriptor>
                                <creditInstallment>
                                        <numberOfInstallments>2</numberOfInstallments>
                                        <chargeInterest>N</chargeInterest>
                                </creditInstallment>
                        </payment>
                </sale>
        </order>
</transaction-request>

 

Dados Comprador – Exemplo de Retorno em Caso de Sucesso

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
        <authCode>123456</authCode>
        <orderID>0A01159A:01579A823023:5A61:16B7115E</orderID>
        <referenceNum>1234567890</referenceNum>
        <transactionID>160376584</transactionID>
        <transactionTimestamp>1475766032</transactionTimestamp>
        <responseCode>0</responseCode>
        <responseMessage>CAPTURED</responseMessage>
        <avsResponseCode>YYY</avsResponseCode>
        <cvvResponseCode>M</cvvResponseCode>
        <processorCode>A</processorCode>
        <processorMessage>APPROVED</processorMessage>
        <errorMessage/>
        <creditCardCountry>US</creditCardCountry>
        <creditCardScheme>Visa</creditCardScheme>
</transaction-response>

 

Dados Comprador – Exemplo de Retorno em Caso de Erro

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<api-error>
        <errorCode>1</errorCode>
        <errorMsg>
                <![CDATA[processor not found ]]>
        </errorMsg>
</api-error>

 

Dados Comprador – Tabela de Parâmetros

 

Nome

Obrigatório

Tamanho

Descrição

name

Sim

 64 Billing: nome impresso no cartão

Shipping: nome do destinatário

address

Sim

128 Billing: endereço da fatura do cartão

Shipping: endereço de entrega do produto.

address2

Sim

 128 Billing/Shipping: complemento
city

Sim

 64 Billing/Shipping: cidade
state

Sim

32 Billing/Shipping: estado
postalcode

Sim

16 Billing/Shipping: CEP
country

Sim

 64 Billing/Shipping: país com 2 letras (ISO-3166-2)
phone

Sim

 16 Billing: número telefone portador do cartão

Shipping: número telefone do destinatário

email

Sim

 128 Billing: e-mail do portador do cartão

Shipping: e-mail do destinatário

companyName

Sim

 64 Billing: Nome da empresa