{"id":1490,"date":"2018-05-07T09:18:31","date_gmt":"2018-05-07T12:18:31","guid":{"rendered":"http:\/\/maxipago.com\/developers\/?page_id=1490"},"modified":"2025-09-26T20:34:49","modified_gmt":"2025-09-26T23:34:49","slug":"notificacoes-webhook","status":"publish","type":"page","link":"https:\/\/www.maxipago.com\/developers\/apidocs\/notificacoes-webhook\/","title":{"rendered":"Servi\u00e7o de Notifica\u00e7\u00e3o (webhook)"},"content":{"rendered":"\n
<\/div>\n\n\n\n

O Webhooks \u00e9 a pr\u00e1tica de recebimento de informa\u00e7\u00f5es de forma passiva atrav\u00e9s de uma URL https (Localizador padr\u00e3o de recursos). Com o Webhooks da maxiPago! o recebimento ser\u00e1 sobre status das transa\u00e7\u00f5es.<\/p>\n\n\n\n

<\/div>\n\n\n\n
\n

ATEN\u00c7\u00c3O<\/span>:<\/strong><\/p>\n\n\n\n

A URL de recebimento das informa\u00e7\u00f5es deve ser criada e enviada para a maxiPago! para cadastro.<\/p>\n\n\n\n

A URL deve ter status 200 OK, qualquer status diferente impossibilitar\u00e1 o funcionamento do Webhooks.<\/p>\n\n\n\n

URL de webhook n\u00e3o pode conter IP em sua composi\u00e7\u00e3o.<\/p>\n\n\n\n

A URL dever\u00e1 seguir o seguinte exemplo de estrutura: https:\/\/sualoja.com\/suasvendas\/resultados<\/p>\n\n\n\n

<\/div>\n\n\n\n

<\/p>\n<\/blockquote>\n\n\n\n

<\/div>\n\n\n\n

Funcionamento<\/h3>\n\n\n\n
<\/div>\n\n\n\n

Para funcionamento do Webhooks, a URL de callback deve ser criada e ficar online constantemente. Essa URL precisa ser informada ao time de Suporte e Integra\u00e7\u00e3o para valida\u00e7\u00e3o (suporte.mp@userede.com.br) e posterior publica\u00e7\u00e3o no ambiente de produ\u00e7\u00e3o.<\/p>\n\n\n\n

A maxiPago! faz o envio das informa\u00e7\u00f5es utilizando uma comunica\u00e7\u00e3o https enviando um XML dentro de um objeto chamado \u201cXML\u201d atrav\u00e9s do m\u00e9todo POST com o Header \u201ccontent-type: x-www-form-urlencoded\u201d, portanto, a URL deve estar preparada para este tipo de requisi\u00e7\u00e3o:<\/p>\n\n\n\n

Abaixo, um modelo de requisi\u00e7\u00e3o que ser\u00e1 enviado pela maxiPago!:<\/p>\n\n\n\n

<\/div>\n\n\n\n

Headers<\/h4>\n\n\n\n

Content-type<\/strong>: x-www-form-urlencoded
Pragma<\/strong>: no-cache
Cache-control<\/strong>: no-cache
Connection<\/strong>: keep-alive
User-agent<\/strong>: xxxx
Host<\/strong>: xxxx
Accept<\/strong>: xxx
Content-length<\/strong>: xxx<\/p>\n\n\n\n

Tipos de Transa\u00e7\u00f5es Reportadas<\/span><\/h3>\n\n\n\n
<\/div>\n\n\n\n

O Webhooks da maxiPago! envia informa\u00e7\u00f5es para a URL cadastrada sobre os seguintes tipos de transa\u00e7\u00f5es:<\/p>\n\n\n\n

\n \n \n \n \n <\/colgroup>\n <\/table>\n \n \n \n<\/div>\n\n\n\n\n

 <\/h4>\n\n\n\n

Body<\/span><\/span><\/h3>\n\n\n\n
<\/div>\n\n\n\n

Cart\u00e3o de cr\u00e9dito (captura – response para Adquirente Rede)<\/strong><\/span><\/h4>\n\n\n\n
<\/div>\n\n\n\n
xml=<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Request>\n    <transaction-event>\n        <brandMessage>Success.<\/brandMessage>\n        <brandCode>00<\/brandCode>\n        <processorCode>00<\/processorCode>\n        <transactionStatus>3<\/transactionStatus>\n        <transactionType>CreditCardCapture<\/transactionType>\n        <transactionID>520330398<\/transactionID>\n        <tid>11182212131744289937<\/tid>\n        <brandTid><\/brandTid>\n        <orderID>0A0115CD:01850D44AB52:262C:156EDFB5<\/orderID>\n        <transactionState>Captured<\/transactionState>\n        <transactionDate>12-13-2022 17:54:46<\/transactionDate>\n        <nsu>384248853<\/nsu>\n        <merchantId>36xxx<\/merchantId>\n        <referenceNumber>2022121317515887<\/referenceNumber>\n        <transactionAmount>1<\/transactionAmount>\n        <processorMessage>Success.<\/processorMessage>\n    <\/transaction-event>\n<\/Request><\/pre>\n\n\n\n

Cart\u00e3o de cr\u00e9dito (Captura – response para demais Adquirentes)<\/strong><\/h4>\n\n\n\n
<\/div>\n\n\n\n
xml=<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Request>\n\t<transaction-event>\n\t\t<processorCode>00<\/processorCode>\n\t\t<transactionStatus>3<\/transactionStatus>\n\t\t<transactionType>CreditCardCapture<\/transactionType>\n\t\t<transactionID>520330398<\/transactionID>\n\t\t<tid>11182212131744289937<\/tid>\n\t\t<brandTid><\/brandTid>\n\t\t<orderID>0A0115CD:01850D44AB52:262C:156EDFB5<\/orderID>\n\t\t<transactionState>Captured<\/transactionState>\n\t\t<transactionDate>12-13-2022 17:54:46<\/transactionDate>\n\t\t<nsu>384248853<\/nsu>\n\t\t<merchantId>3xxxx<\/merchantId>\n\t\t<referenceNumber>2022121317515887<\/referenceNumber>\n\t\t<transactionAmount>1<\/transactionAmount>\n\t\t<processorMessage>Success.<\/processorMessage>\n\t<\/transaction-event>\n<\/Request><\/pre>\n\n\n\n
<\/div>\n\n\n\n
Cart\u00e3o de cr\u00e9dito (Declinado – response para Adquirente Rede)<\/strong><\/h4>\n\n\n\n
<\/div>\n\n\n\n
xml=<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Request>\n\t<transaction-event>\n\t\t<brandMessage>Affiliation: Invalid parameter format.<\/brandMessage>\n\t\t<brandCode>25<\/brandCode>\n\t\t<processorCode>25<\/processorCode>\n\t\t<transactionStatus>7<\/transactionStatus>\n\t\t<transactionType>CreditCardSale<\/transactionType>\n\t\t<transactionID>13958523<\/transactionID>\n\t\t<tid><\/tid>\n\t\t<brandTid><\/brandTid>\n\t\t<orderID>0A010497:0184F87F5A52:9816:5079CE74<\/orderID>\n\t\t<transactionState>Declined<\/transactionState>\n\t\t<transactionDate>12-09-2022 17:06:46<\/transactionDate>\n\t\t<nsu><\/nsu>\n\t\t<merchantId>1xxxxx<\/merchantId>\n\t\t<referenceNumber>Order-202212099255<\/referenceNumber>\n\t\t<transactionAmount>10.00<\/transactionAmount>\n\t\t<processorMessage>Affiliation: Invalid parameter format.<\/processorMessage>\n\t<\/transaction-event>\n<\/Request>\n<\/pre>\n\n\n\n
Cart\u00e3o de cr\u00e9dito (Declinado – response para demais Adquirentes)<\/strong><\/strong><\/h4>\n\n\n\n
<\/div>\n\n\n\n
xml=<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Request>\n\t<transaction-event>\n\t\t<processorCode>25<\/processorCode>\n\t\t<transactionStatus>7<\/transactionStatus>\n\t\t<transactionType>CreditCardSale<\/transactionType>\n\t\t<transactionID>13958523<\/transactionID>\n\t\t<tid><\/tid>\n\t\t<brandTid><\/brandTid>\n\t\t<orderID>0A010497:0184F87F5A52:9816:5079CE74<\/orderID>\n\t\t<transactionState>Declined<\/transactionState>\n\t\t<transactionDate>12-09-2022 17:06:46<\/transactionDate>\n\t\t<nsu><\/nsu>\n\t\t<merchantId>1xxxxx<\/merchantId>\n\t\t<referenceNumber>Order-202212099255<\/referenceNumber>\n\t\t<transactionAmount>10.00<\/transactionAmount>\n\t\t<processorMessage>Affiliation: Invalid parameter format.<\/processorMessage>\n\t<\/transaction-event>\n<\/Request>\n<\/pre>\n\n\n\n
Cart\u00e3o de cr\u00e9dito (Cancelamento)<\/strong><\/h4>\n\n\n\n
xml=<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<transaction-response>\n\t<authCode\/>\n\t<orderID\/>\n\t<referenceNum>4040764123<\/referenceNum>\n\t<transactionID>460312421<\/transactionID>\n\t<transactionTimestamp\/>\n\t<responseCode>0<\/responseCode>\n\t<responseMessage>VOIDED<\/responseMessage>\n\t<avsResponseCode\/>\n\t<cvvResponseCode\/>\n\t<processorCode>173<\/processorCode>\n\t<processorMessage>Authorization expired.<\/processorMessage>\n\t<processorName>REDE<\/processorName>\n\t<errorMessage\/>\n\t<creditCardScheme>Visa<\/creditCardScheme>\n<\/transaction-response>\n<\/pre>\n\n\n\n
<\/p>\n\n\n\n
Boleto Banc\u00e1rio (visualizado)<\/strong><\/p>\n\n\n\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Request>\n\t<transaction-event>\n\t\t<transactionStatus>34<\/transactionStatus>\n\t\t<transactionType>30<\/transactionType>\n\t\t<transactionID>50141321<\/transactionID>\n\t\t<transactionState>VIEWED<\/transactionState>\n\t\t<orderID>0A013593:019985GH71BF:6721:009CAS95<\/orderID>\n\t\t<recurringFlag><\/recurringFlag>\n\t\t<transactionDate>09-26-2025 04:50:40<\/transactionDate>\n\t\t<merchantId>xxxx<\/merchantId>\n\t\t<referenceNumber>12345678<\/referenceNumber>\n\t\t<transactionAmount>1.00<\/transactionAmount>\n\t<\/transaction-event>\n<\/Request>\n<\/pre>\n\n\n\n
Boleto Banc\u00e1rio (pago)<\/strong><\/p>\n\n\n\n
x<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Request>\n\t<transaction-event>\n\t\t<processorCode>200<\/processorCode>\n\t\t<transactionStatus>10<\/transactionStatus>\n\t\t<transactionType>BoletoSale<\/transactionType>\n\t\t<transactionID>79238186<\/transactionID>\n\t\t<orderID>0A4415FB:019984446BAC:F368:6DDA66DE<\/orderID>\n\t\t<transactionState>Settled<\/transactionState>\n\t\t<transactionDate>09-25-2025 11:42:31<\/transactionDate>\n\t\t<merchantId>xxxxx<\/merchantId>\n\t\t<referenceNumber>543620<\/referenceNumber>\n\t\t<transactionAmount>1.00<\/transactionAmount>\n\t\t<processorMessage><\/processorMessage>\n\t<\/transaction-event>\n<\/Request>\n<\/pre>\n\n\n\n
Recorr\u00eancia (opera\u00e7\u00e3o acatada)<\/strong><\/p>\n\n\n\n
xml=<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Request>\n    <transaction-event>\n        <orderID>0A0115CD:01850D44AB52:262C:156EDFB5<\/orderID>\n        <merchantId>716413<\/merchantId>\n        <recurringFlag>Y<\/recurringFlag>\n        <transactionDate>08-13-2024 17:54:46<\/transactionDate>\n        <brandCode>00<\/brandCode>\n        <brandTid>MBKRL4UJX0510<\/brandTid>\n        <referenceNumber>29506_CARTAO_1715282846.271611<\/referenceNumber>\n        <transactionType>CreditCardSale<\/transactionType>\n        <nsu>84248853<\/nsu>\n        <transactionStatus>3<\/transactionStatus>\n        <transactionID>621326149<\/transactionID>\n        <processorCode>00<\/processorCode>\n        <transactionAmount>0.01<\/transactionAmount>\n        <brandMessage>Success.<\/brandMessage>\n        <tid>10482405100408363699<\/tid>\n        <transactionState>Captured<\/transactionState>\n        <recurring>\n            <status>ACTIVE<\/status>\n            <failedThreshold>3<\/failedThreshold>\n            <onFailureAction>skip<\/onFailureAction>\n            <runCount>2<\/runCount>\n            <numberOfFailures>0<\/numberOfFailures>\n            <numberOfInstallments>-1<\/numberOfInstallments>\n        <\/recurring>\n        <processorMessage>Success.<\/processorMessage>\n    <\/transaction-event>\n<\/Request>\n<\/pre>\n\n\n\n
Recorr\u00eancia (opera\u00e7\u00e3o declinada)<\/strong><\/p>\n\n\n\n
xml=<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Request>\n    <transaction-event>\n        <orderID>0A0115CD:01850D44AB52:262C:156EDFB5<\/orderID>\n        <merchantId>716413<\/merchantId>\n        <recurringFlag>Y<\/recurringFlag>\n        <transactionDate>08-13-2024 17:54:46<\/transactionDate>\n        <brandCode>00<\/brandCode>\n        <brandTid>MBKRL4UJX0510<\/brandTid>\n        <referenceNumber>29506_CARTAO_1715282846.271611<\/referenceNumber>\n        <transactionType>CreditCardSale<\/transactionType>\n        <nsu>84248853<\/nsu>\n        <transactionStatus>7<\/transactionStatus>\n        <transactionID>621326149<\/transactionID>\n        <processorCode>00<\/processorCode>\n        <transactionAmount>0.01<\/transactionAmount>\n        <brandMessage>Declined by Rede: Issuer will never approve<\/brandMessage>\n        <tid>10482405100408363699<\/tid>\n        <transactionState>Declined<\/transactionState>\n        <recurring>\n            <status>ACTIVE<\/status>\n            <failedThreshold>3<\/failedThreshold>\n            <onFailureAction>skip<\/onFailureAction>\n            <runCount>2<\/runCount>\n            <numberOfFailures>0<\/numberOfFailures>\n            <numberOfInstallments>-1<\/numberOfInstallments>\n        <\/recurring>\n\t<processorMessage>Unauthorized. Contact Rede.<\/processorMessage>\n    <\/transaction-event>\n<\/Request>\n<\/pre>\n\n\n\n
Fraude (aprovada)<\/strong><\/p>\n\n\n\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Request>\n\t<transaction-event>\n\t\t<transactionStatus>44<\/transactionStatus>\n\t\t<transactionType>FraudInquiry<\/transactionType>\n\t\t<transactionID>501043<\/transactionID>\n\t\t<orderID>7F000101:015DF791E89B:C66D:79BA05A3<\/orderID>\n\t\t<transactionState>Fraud Approved<\/transactionState>\n\t\t<transactionDate>09-26-2025 10:14:02<\/transactionDate>\n\t\t<merchantId>xxxxx<\/merchantId>\n\t\t<referenceNumber>20200001<\/referenceNumber>\n\t\t<transactionAmount>1.00<\/transactionAmount>\n\t<\/transaction-event>\n<\/Request>\n<\/pre>\n\n\n\n
Fraude (declinada)<\/strong><\/p>\n\n\n\n
xml=<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Request>\n    <transaction-event>\n        <transactionStatus>45<\/transactionStatus>\n        <transactionType>CreditCardSale<\/transactionType>\n        <transactionID>501043<\/transactionID>\n        <tid>1006993069000AC96D2A<\/tid>\n        <orderID>7F000101:015DF791E89B:C66D:79BA05A3<\/orderID>\n        <transactionState>Fraud Declined<\/transactionState>\n        <transactionDate>08-19-2017 00:56:27<\/transactionDate>\n        <nsu>310802<\/nsu>\n        <merchantId>1xxxx<\/merchantId>\n        <transactionAmount>24.00<\/transactionAmount>\n        <referenceNumber>20200001<\/referenceNumber>\n    <\/transaction-event>\n<\/Request>\n<\/pre>\n\n\n\n
Pix<\/strong><\/p>\n\n\n\n
xml=<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Request>\n    <transaction-event>\n        <transactionStatus>3<\/transactionStatus>\n        <transactionType>PixSale<\/transactionType>\n        <orderID>0A01049C:017D4824A517:6280:5556432E<\/orderID>\n        <transactionState>Captured<\/transactionState>\n        <transactionDate>08-19-2017 00:56:27<\/transactionDate>        \n        <merchantId>1xxxx<\/merchantId>\n        <transactionAmount>24.00<\/transactionAmount>\n        <referenceNumber>20200001<\/referenceNumber>\n    <\/transaction-event>\n<\/Request>\n<\/pre>\n\n\n\n
Tabela de Par\u00e2metros Enviados:
<\/span><\/h3>\n\n\n\n
<\/div>\n\n\n
\n

\n \n \n \n <\/colgroup>\n <\/table>\n \n \n \n<\/div>\n\n\n\n\n
<\/div>\n\n\n\n

Libera\u00e7\u00e3o dos IP\u00b4s maxiPago!<\/span><\/strong><\/h4>\n\n\n