A autorização ou pré-autorização é a ação que sensibiliza o limite do cartão de crédito do cliente, porém não há a confirmação (captura) da transação, ou seja, não gera cobrança para o consumidor.
Autorização – URLs Para Envio dos Dados
SANDBOX: https://testapi.maxipago.net/UniversalAPI/postXML
PRODUÇÃO: https://api.maxipago.net/UniversalAPI/postXML
Autorização – 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> <auth> <processorID>1</processorID> <referenceNum>Sandbox_teste_1</referenceNum> <fraudCheck>N</fraudCheck> <ipAddress>192.168.0.10</ipAddress> <customerIdExt>192.168.0.10</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> </auth> </order> </transaction-request>
Autorização – Exemplo de Retorno em Caso de Sucesso
<?xml version="1.0" encoding="UTF-8"?> <transaction-response> <authCode>123456</authCode> <orderID>0A0104A3:01621AACC4D6:3867:47710E49</orderID> <referenceNum>Sandbox_teste_1</referenceNum> <transactionID>1791850</transactionID> <transactionTimestamp>1520865952</transactionTimestamp> <responseCode>0</responseCode> <responseMessage>AUTHORIZED</responseMessage> <avsResponseCode>YYY</avsResponseCode> <cvvResponseCode>M</cvvResponseCode> <processorCode>A</processorCode> <processorMessage>APPROVED</processorMessage> <processorName>SIMULATOR</processorName> <creditCardBin>551015</creditCardBin> <creditCardLast4>2409</creditCardLast4> <errorMessage/> <processorTransactionID>237476</processorTransactionID> <processorReferenceNumber>301519</processorReferenceNumber> <creditCardCountry>US</creditCardCountry> <creditCardScheme>Mastercard</creditCardScheme> </transaction-response>
Autorização – Exemplo de Retorno com Erro
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <api-error> <errorCode>1</errorCode> <errorMsg> <![CDATA[Schema validation for the vertical SA for the incoming transaction xml failed. Reason Parser Error: URI=null Line=1:cvc-datatype-valid.1.2.1: '1,00' is not a valid value for 'decimal'.]]> </errorMsg> </api-error>
Autorização – Exemplo de Retorno de Erro cartão Mastercard
A bandeira Mastercard não considera as classificações dos códigos ABECS, mas sim a classificação dos códigos complementares de recusa chamados de MAC – Merchant Code Advice, que fornecem instruções sobre que ações o estabelecimento pode tomar para aprovar a transação.
Os códigos MAC acompanham o código de negativa quando uma transação é negada e indicam se aquela transação pode ser retentada (reversível) ou não (irreversível).
Os valores de MAC possíveis podem ser consultados no link: https://developer.userede.com.br/e-rede#tarifas-bandeira
<?xml version="1.0" encoding="UTF-8"?> <transaction-response> <authCode/> <orderID>0A01048A:01889278CA5B:D150:30896CE3</orderID> <referenceNum>060620231748</referenceNum> <transactionID>14361802</transactionID> <transactionTimestamp>1686084569</transactionTimestamp> <responseCode>1</responseCode> <responseMessage>DECLINED</responseMessage> <avsResponseCode/> <cvvResponseCode/> <processorCode>58</processorCode> <processorMessage>Unauthorized. Contact issuer.</processorMessage> <processorName>REDE</processorName> <creditCardBin>544828</creditCardBin> <creditCardLast4>0007</creditCardLast4> <errorMessage/> <processorTransactionID>10012307131548367437</processorTransactionID> <processorReferenceNumber>77735575</processorReferenceNumber> <creditCardScheme>Mastercard</creditCardScheme> <brandCode>82</brandCode> <brandMessage>Policy (Mastercard use only)</brandMessage> <brandTransactionID>828903</brandTransactionID> <brandMac>02</brandMac> </transaction-response>
Autorização – 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