{"id":335,"date":"2017-02-15T14:19:35","date_gmt":"2017-02-15T16:19:35","guid":{"rendered":"http:\/\/maxipago.com\/developers\/?page_id=335"},"modified":"2025-01-17T15:58:52","modified_gmt":"2025-01-17T18:58:52","slug":"tabela-de-retornos","status":"publish","type":"page","link":"https:\/\/www.maxipago.com\/developers\/apidocs\/maxipago\/tabela-de-retornos\/","title":{"rendered":"Retorno da Transa\u00e7\u00e3o"},"content":{"rendered":"

O retorno das requisi\u00e7\u00f5es de transa\u00e7\u00e3o possui um padr\u00e3o \u00fanico, independentemente do tipo de transa\u00e7\u00e3o efetuada. Contudo, nem todos os campos s\u00e3o retornados em todas as transa\u00e7\u00f5es.<\/p>\n

Transa\u00e7\u00e3o Aprovada<\/h3>\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<transaction-response>\n    <authCode>005772<\/authCode>\n    <orderID>7F000001:013829A1C09E:8DE9:016891F0<\/orderID>\n    <referenceNum>123456789<\/referenceNum>\n    <transactionID>1418605<\/transactionID>\n    <transactionTimestamp>1340728262<\/transactionTimestamp>\n    <responseCode>0<\/responseCode>\n    <responseMessage>CAPTURED<\/responseMessage>\n    <avsResponseCode\/>\n    <cvvResponseCode\/>\n    <processorCode>0<\/processorCode>\n    <processorMessage>APPROVED<\/processorMessage>\n    <errorMessage\/>\n    <processorTransactionID>2612953<\/processorTransactionID>\n    <processorReferenceNumber>689472845<\/processorReferenceNumber>\n    <fraudScore>29<\/fraudScore>\n    <save-on-file>\n        <token>eBUv\/SIBJv0=<\/token>\n    <\/save-on-file>\n<\/transaction-response><\/pre>\n
Transa\u00e7\u00e3o Negada<\/h3>\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<transaction-response>\n    <authCode\/>\n    <orderID>7F000001:013D16CF1461:F0EF:014EDA77<\/orderID>\n    <referenceNum>2012071201<\/referenceNum>\n    <transactionID>3308<\/transactionID>\n    <transactionTimestamp>1361887302962<\/transactionTimestamp>\n    <responseCode>1<\/responseCode>\n    <responseMessage>DECLINED<\/responseMessage>\n    <avsResponseCode>NNN<\/avsResponseCode>\n    <cvvResponseCode>N<\/cvvResponseCode>\n    <processorCode>D<\/processorCode>\n    <processorMessage>DECLINED<\/processorMessage>\n    <errorMessage\/>\n<\/transaction-response><\/pre>\n
Transa\u00e7\u00e3o Com Par\u00e2metros Inv\u00e1lidos<\/h3>\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<transaction-response>\n    <authCode\/>\n    <orderID\/>\n    <referenceNum\/>\n    <transactionID\/>\n    <transactionTimestamp>1361887531821<\/transactionTimestamp>\n    <responseCode>1024<\/responseCode>\n    <responseMessage>INVALID REQUEST<\/responseMessage>\n    <avsResponseCode\/>\n    <cvvResponseCode\/>\n    <processorCode\/>\n    <processorMessage\/>\n    <errorMessage>Credit Card Number is not a valid credit card number.<\/errorMessage>\n<\/transaction-response><\/pre>\n
Transa\u00e7\u00e3o Com Erro<\/h3>\n
<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<api-error>\n    <errorCode>1<\/errorCode>\n    <errorMsg>\n        <![CDATA[Schema validation for the vertical SA for the incoming transaction xml failed. Reason Parser Error: URI=null Line=1: cvcdatatype-valid.1.2.1:'100,01' is not a valid value for 'decimal'.]]>\n    <\/errorMsg>\n<\/api-error><\/pre>\n
Erros mais comuns para o erro 1024<\/h3>\n\n\n\n<\/colgroup>\n\n\n\n\n\n\n\n
 
\n
Mensagem<\/strong><\/p>\n<\/td>\n
\n
Descri\u00e7\u00e3o<\/strong><\/p>\n<\/td>\n<\/tr>\n
\n
Credit Card Number is not a valid credit card number<\/p>\n<\/td>\n
\n
N\u00famero de cart\u00e3o de cr\u00e9dito n\u00e3o \u00e9 v\u00e1lido<\/p>\n<\/td>\n<\/tr>\n
\n
The transaction has an expired credit car<\/p>\n<\/td>\n
\n
Data de vencimento do cart\u00e3o n\u00e3o \u00e9 valida<\/p>\n<\/td>\n<\/tr>\n
\n
A transaction with boletoNumber = XXX already exists in the data base<\/p>\n<\/td>\n
\n
O campo \u2018boletoNumber\u2019 enviado j\u00e1 existe em nosso sistema para este lojista<\/p>\n<\/td>\n<\/tr>\n
\n
Transaction Amount is not a valid number in the range of 0.01 to 1.0E14<\/p>\n<\/td>\n
\n
O valor da transa\u00e7\u00e3o n\u00e3o \u00e9 v\u00e1lido<\/p>\n<\/td>\n<\/tr>\n
\n
Reques tis invalid and can not be processed<\/p>\n<\/td>\n
\n
O campo \u2018processorID\u2019 enviado n\u00e3o \u00e9 v\u00e1lido.<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Par\u00e2metros retornados no <transaction-response\/><\/h3>\n\n\n\n<\/colgroup>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
 
\n
Nome<\/strong><\/p>\n<\/td>\n
\n
Descri\u00e7\u00e3o<\/strong><\/p>\n<\/td>\n<\/tr>\n
\n
boletoURL<\/p>\n<\/td>\n
\n
URL para gera\u00e7\u00e3o do Boleto<\/p>\n
Recomenda-se salvar esta URL para uso futuro<\/p>\n<\/td>\n<\/tr>\n
\n
onlineDebitURL<\/p>\n<\/td>\n
\n
URL para redirecionamento do d\u00e9bito online<\/p>\n
O cliente deve ser redirecionado para esta URL para completar a transa\u00e7\u00e3o<\/p>\n<\/td>\n<\/tr>\n
\n
authenticationURL<\/p>\n<\/td>\n
\n
URL de autentica\u00e7\u00e3o<\/p>\n
O cliente deve ser redirecionado para esta URL para completar a etapa de autentica\u00e7\u00e3o<\/p>\n<\/td>\n<\/tr>\n
\n
authCode<\/p>\n<\/td>\n
\n
C\u00f3digo de autoriza\u00e7\u00e3o retornado pela adquirente<\/p>\n<\/td>\n<\/tr>\n
\n
referenceNum<\/p>\n<\/td>\n
\n
Confirma\u00e7\u00e3o do c\u00f3digo enviado na requisi\u00e7\u00e3o<\/p>\n<\/td>\n<\/tr>\n
\n
orderID<\/p>\n<\/td>\n
\n
ID do pedido, gerado pela maxiPago!<\/p>\n
Deve-se salvar este campo para futuras refer\u00eancias ao pedido<\/p>\n<\/td>\n<\/tr>\n
\n
transactionID<\/p>\n<\/td>\n
\n
Id da transa\u00e7\u00e3o, gerado pela maxiPago!<\/p>\n
Deve-se salvar este campo para futuras refer\u00eancias ao pedido<\/p>\n<\/td>\n<\/tr>\n
\n
transactionTimestamp<\/p>\n<\/td>\n
\n
Data\/hora da transa\u00e7\u00e3o em formato epoch<\/p>\n<\/td>\n<\/tr>\n
\n
responseCode<\/p>\n<\/td>\n
\n
Indicador do status da transa\u00e7\u00e3o na maxiPago!<\/p>\n
Voc\u00ea deve utilizar apenas este campo para validar o resultado de uma transa\u00e7\u00e3o. N\u00e3o utilize outros campos da resposta para determinar o sucesso ou falha de uma transa\u00e7\u00e3o.<\/p>\n
0 = aprovada (*)<\/p>\n
1 = negada<\/p>\n
2 = negada por duplicidade ou fraude<\/p>\n
5 = em revis\u00e3o (an\u00e1lise manual de fraude)<\/p>\n
1022 = erro na operadora do cart\u00e3o<\/p>\n
1023 = processamento rejeitado pelo parceiro<\/p>\n
1024 = erro nos par\u00e2metros enviados<\/p>\n
Ver \u2018responseMessage\u2019 para mais informa\u00e7\u00f5es<\/p>\n
1025 = erro nas credenciais<\/p>\n
2048 = erro interno na maxiPago!<\/p>\n
4097 = timeout com a adquirente<\/p>\n
(*): para adquirente com estorno online, o valor 0 significa que o estorno j\u00e1 foi processado, para os offline significa que o estorno est\u00e1 sendo processado (neste caso pode ser posteriormente verificado pela API de consulta)<\/p>\n<\/td>\n<\/tr>\n
\n
responseMessage<\/p>\n<\/td>\n
\n
Mensagem de resposta da transa\u00e7\u00e3o<\/p>\n<\/td>\n<\/tr>\n
\n
avsResponseCode<\/p>\n<\/td>\n
\n
Resposta da verifica\u00e7\u00e3o AVS, se houver:<\/p>\n
-X: o n\u00famero da rua e o CEP batem<\/p>\n
-A: o n\u00famero da rua bate, mas o CEP n\u00e3o<\/p>\n
-N: nem o n\u00famero da rua nem o CEP batem<\/p>\n
-S: o servi\u00e7o n\u00e3o est\u00e1 dispon\u00edvel para este cart\u00e3o<\/p>\n
-C: servi\u00e7o indispon\u00edvel<\/p>\n
-W: o CEP bate, mas o n\u00famero da rua n\u00e3o<\/p>\n
Obs.: sugerimos que a resposta AVS seja usada para avalia\u00e7\u00e3o manual do risco.<\/p>\n<\/td>\n<\/tr>\n
\n
processorCode<\/p>\n<\/td>\n
\n
C\u00f3digo de retorno da Adquirente<\/p>\n
Linha digit\u00e1vel do boleto<\/p>\n<\/td>\n<\/tr>\n
\n
processorMessage<\/p>\n<\/td>\n
\n
Mensagem de retorno da adquirente<\/p>\n<\/td>\n<\/tr>\n
\n
processorReferenceNumber<\/p>\n<\/td>\n
\n
N\u00famero de refer\u00eancia da adquirente<\/p>\n
Cielo: TID<\/p>\n
Rede: NSU<\/p>\n<\/td>\n<\/tr>\n
\n
processorTransactionID<\/p>\n<\/td>\n
\n
ID da transa\u00e7\u00e3o na adquirente<\/p>\n
Cielo: NDU<\/p>\n
Rede: comprovante de venda (CV)<\/p>\n<\/td>\n<\/tr>\n
\n
fraudScore<\/p>\n<\/td>\n
\n
Valor de score retornado pelo fraudControl!<\/p>\n
Quanto menor o valor, menor o risco da transa\u00e7\u00e3o.<\/p>\n<\/td>\n<\/tr>\n
\n
errorMessage<\/p>\n<\/td>\n
\n
Mensagem de erro, se houver<\/p>\n<\/td>\n<\/tr>\n
\n
token<\/p>\n<\/td>\n
\n
Presente s\u00f3 quando um cart\u00e3o \u00e9 salvo automaticamente, traz o token \u00fanico daquele cart\u00e3o. Vem dentro do elemento <save-on-file\/>. \u00c9 muito importante guardar esta informa\u00e7\u00e3o para futura refer\u00eancia!<\/p>\n<\/td>\n<\/tr>\n
\n
error<\/p>\n<\/td>\n
\n
Presente s\u00f3 quando h\u00e1 erro na tentativa de salvar automaticamente o cart\u00e3o, traz a mensagem de erro. Vem dentro do elemento <save-on-file\/>.<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n","protected":false},"excerpt":{"rendered":"
O retorno das requisi\u00e7\u00f5es de transa\u00e7\u00e3o possui um padr\u00e3o \u00fanico, independentemente do tipo de transa\u00e7\u00e3o efetuada. Contudo, nem todos os campos s\u00e3o retornados em todas as transa\u00e7\u00f5es. Transa\u00e7\u00e3o Aprovada <?xml version=”1.0″ encoding=”UTF-8″?> <transaction-response> <authCode>005772<\/authCode> <orderID>7F000001:013829A1C09E:8DE9:016891F0<\/orderID> <referenceNum>123456789<\/referenceNum> <transactionID>1418605<\/transactionID> <transactionTimestamp>1340728262<\/transactionTimestamp> <responseCode>0<\/responseCode> <responseMessage>CAPTURED<\/responseMessage> <avsResponseCode\/> <cvvResponseCode\/> <processorCode>0<\/processorCode> <processorMessage>APPROVED<\/processorMessage> <errorMessage\/> <processorTransactionID>2612953<\/processorTransactionID> <processorReferenceNumber>689472845<\/processorReferenceNumber> <fraudScore>29<\/fraudScore> <save-on-file> <token>eBUv\/SIBJv0=<\/token> <\/save-on-file> <\/transaction-response> Transa\u00e7\u00e3o Negada <?xml […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":23,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"spay_email":"","footnotes":""},"yoast_head":"\nRetorno da Transa\u00e7\u00e3o - Gateway Rede! Developers<\/title>\n<meta name=\"robots\" content=\"noindex, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta property=\"og:locale\" content=\"pt_BR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Retorno da Transa\u00e7\u00e3o - Gateway Rede! Developers\" \/>\n<meta property=\"og:description\" content=\"O retorno das requisi\u00e7\u00f5es de transa\u00e7\u00e3o possui um padr\u00e3o \u00fanico, independentemente do tipo de transa\u00e7\u00e3o efetuada. Contudo, nem todos os campos s\u00e3o retornados em todas as transa\u00e7\u00f5es. Transa\u00e7\u00e3o Aprovada <?xml version="1.0" encoding="UTF-8"?> <transaction-response> <authCode>005772<\/authCode> <orderID>7F000001:013829A1C09E:8DE9:016891F0<\/orderID> <referenceNum>123456789<\/referenceNum> <transactionID>1418605<\/transactionID> <transactionTimestamp>1340728262<\/transactionTimestamp> <responseCode>0<\/responseCode> <responseMessage>CAPTURED<\/responseMessage> <avsResponseCode\/> <cvvResponseCode\/> <processorCode>0<\/processorCode> <processorMessage>APPROVED<\/processorMessage> <errorMessage\/> <processorTransactionID>2612953<\/processorTransactionID> <processorReferenceNumber>689472845<\/processorReferenceNumber> <fraudScore>29<\/fraudScore> <save-on-file> <token>eBUv\/SIBJv0=<\/token> <\/save-on-file> <\/transaction-response> Transa\u00e7\u00e3o Negada <?xml […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.maxipago.com\/developers\/apidocs\/maxipago\/tabela-de-retornos\/\" \/>\n<meta property=\"og:site_name\" content=\"Gateway Rede! Developers\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/maxiPago-193308344142172\/?fref=ts\" \/>\n<meta property=\"article:modified_time\" content=\"2025-01-17T18:58:52+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary\" \/>\n<meta name=\"twitter:label1\" content=\"Est. tempo de leitura\">\n\t<meta name=\"twitter:data1\" content=\"3 minutos\">\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.maxipago.com\/developers\/#website\",\"url\":\"https:\/\/www.maxipago.com\/developers\/\",\"name\":\"Gateway Rede! Developers\",\"description\":\"Portal de Desenvolvedores - Gateway Rede!\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/www.maxipago.com\/developers\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"pt-BR\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.maxipago.com\/developers\/apidocs\/maxipago\/tabela-de-retornos\/#webpage\",\"url\":\"https:\/\/www.maxipago.com\/developers\/apidocs\/maxipago\/tabela-de-retornos\/\",\"name\":\"Retorno da Transa\\u00e7\\u00e3o - Gateway Rede! Developers\",\"isPartOf\":{\"@id\":\"https:\/\/www.maxipago.com\/developers\/#website\"},\"datePublished\":\"2017-02-15T16:19:35+00:00\",\"dateModified\":\"2025-01-17T18:58:52+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.maxipago.com\/developers\/apidocs\/maxipago\/tabela-de-retornos\/#breadcrumb\"},\"inLanguage\":\"pt-BR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.maxipago.com\/developers\/apidocs\/maxipago\/tabela-de-retornos\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.maxipago.com\/developers\/apidocs\/maxipago\/tabela-de-retornos\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.maxipago.com\/developers\/\",\"url\":\"https:\/\/www.maxipago.com\/developers\/\",\"name\":\"In\\u00edcio\"}},{\"@type\":\"ListItem\",\"position\":2,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.maxipago.com\/developers\/apidocs\/\",\"url\":\"https:\/\/www.maxipago.com\/developers\/apidocs\/\",\"name\":\"API Docs\"}},{\"@type\":\"ListItem\",\"position\":3,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.maxipago.com\/developers\/apidocs\/maxipago\/\",\"url\":\"https:\/\/www.maxipago.com\/developers\/apidocs\/maxipago\/\",\"name\":\"Documenta\\u00e7\\u00f5es Online\"}},{\"@type\":\"ListItem\",\"position\":4,\"item\":{\"@id\":\"https:\/\/www.maxipago.com\/developers\/apidocs\/maxipago\/tabela-de-retornos\/#webpage\"}}]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","_links":{"self":[{"href":"https:\/\/www.maxipago.com\/developers\/wp-json\/wp\/v2\/pages\/335"}],"collection":[{"href":"https:\/\/www.maxipago.com\/developers\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.maxipago.com\/developers\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.maxipago.com\/developers\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.maxipago.com\/developers\/wp-json\/wp\/v2\/comments?post=335"}],"version-history":[{"count":12,"href":"https:\/\/www.maxipago.com\/developers\/wp-json\/wp\/v2\/pages\/335\/revisions"}],"predecessor-version":[{"id":4325,"href":"https:\/\/www.maxipago.com\/developers\/wp-json\/wp\/v2\/pages\/335\/revisions\/4325"}],"up":[{"embeddable":true,"href":"https:\/\/www.maxipago.com\/developers\/wp-json\/wp\/v2\/pages\/23"}],"wp:attachment":[{"href":"https:\/\/www.maxipago.com\/developers\/wp-json\/wp\/v2\/media?parent=335"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}