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 |
Sim |
64 |
Nome do cliente |
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/distric |
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 (UF)). |
billing/postalcode |
Sim |
16 |
CEP de cobrança. |
billing/country |
Sim |
64 |
País (abreviação de 2 dígitos). |
billing/email |
Sim |
128 |
Utilização obrigatória de “@”. |
billing/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). |
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