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 |
Sim |
128 | Billing: e-mail do portador do cartão
Shipping: e-mail do destinatário |
|
companyName |
Sim |
64 | Billing: Nome da empresa |