{"title":"Cancele um pagamento","category":"default","creationDate":1776961627,"content":"<div class=\"additional-info-block output-inline\">\n<h5 class=\"article__heading additional-info-block__title\">Deseja cancelar um pagamento j\u00e1 autorizado?<\/h5><div class=\"additional-info-block__body\"><p>Se voc\u00ea estiver usando <a href=\"\/pt\/point-of-sale\/capturing-payments\/delayed-capture\">captura com atraso<\/a> ou <a href=\"\/pt\/point-of-sale\/capturing-payments\/manual-capture\">captura manual<\/a> em vez da captura autom\u00e1tica, voc\u00ea poder\u00e1 cancelar uma autoriza\u00e7\u00e3o<\/p><\/div><\/div>\n\n<p>\u00c0s vezes, os clientes mudam de id\u00e9ia no meio da compra ou os funcion\u00e1rios da loja percebem que cometeram um erro enquanto o comprador estava usando o terminal.<\/p>\n<p>Uma solicita\u00e7\u00e3o de cancelamento permite que um cliente ou a equipe da loja aborte um pagamento em andamento. Quando o pedido de cancelamento \u00e9 recebido antes de o pagamento ser <strong>aprovado<\/strong> , o pagamento \u00e9 cancelado.<\/p>\n<p>Aqui explicamos como os pagamentos podem ser cancelados:<\/p>\n<ul>\n<li><a href=\"#cancel-from-register\">De sua caixa refgistradora<\/a><\/li>\n<li><a href=\"#cancel-from-terminal\">De seu termianl<\/a><\/li>\n<\/ul>\n<h2 id=\"cancel-from-register\">Cancele um pagamento de sua caixa registradora<\/h2>\n<p>Enquanto  a <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment\/#step-3-make-a-payment\">solicita\u00e7\u00e3o de pagamento<\/a> estiver em andamento, voc\u00ea poder\u00e1 cancel\u00e1-la fazendo uma solicita\u00e7\u00e3o de cancelamento na sua caixa registradora.<\/p>\n<ol>\n<li>\n<p>Para cancelar um pagamento, fa\u00e7a uma solicita\u00e7\u00e3o POST para o <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#endpoints\">endpoint da API de Terminais<\/a>, especificando:<\/p>\n<ul>\n<li>\n<p>Obejto <code>MessageHeader<\/code>. Este segue a estrutura <code>MessageHeader<\/code> padr\u00e3o, explicada nos <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#request-message-header\">fundamentos da API de terminais<\/a>:<\/p>\n<ul>\n<li><code>ProtocolVersion<\/code>: <strong>3.0<\/strong><\/li>\n<li><code>MessageClass<\/code>: <strong>Service<\/strong><\/li>\n<li><code>MessageCategory<\/code>: <strong>Abort<\/strong>.<\/li>\n<li><code>MessageType<\/code>: <strong>Request<\/strong><\/li>\n<li><code>SaleID<\/code>: Seu ID exclusivo para a caixa registradora que faz o pedido de cancelamento.<\/li>\n<li><code>ServiceID<\/code>: Seu ID exclusivo para esta tentativa de transa\u00e7\u00e3o, consistindo em 1 a 10 caracteres alfanum\u00e9ricos. Esse valor deve ser exclusivo nas \u00faltimas 48 horas.<\/li>\n<li>\n<p><code>POIID<\/code>: ID exclusivo do terminal. Isso indica para qual terminal o pagamento ser\u00e1 roteado.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Objeto  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/abort\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">AbortRequest<\/a> com:<\/p>\n<ul>\n<li><code>AbortReason<\/code>: <strong>MerchantAbort<\/strong><\/li>\n<li><code>MessageReference.MessageCategory<\/code>: <strong>Payment<\/strong><\/li>\n<li><code>MessageReference.SaleID<\/code>: Seu ID exclusivo da caixa registradora que fez a solicita\u00e7\u00e3o de pagamento.<\/li>\n<li><code>MessageReference.ServiceID<\/code>: A solicita\u00e7\u00e3o <code>ServiceID<\/code> do pagamento est\u00e1 sendo cancelada.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>O exemplo abaixo mostra como voc\u00ea faria uma solicita\u00e7\u00e3o para cancelar um pagamento em andamento com um valor <code>ServiceID<\/code> de <strong>21796<\/strong>.<\/p>\n<pre><code class=\"language-json\">{\n  \"SaleToPOIRequest\":{\n    \"MessageHeader\":{\n      \"ProtocolVersion\":\"3.0\",\n      \"MessageClass\":\"Service\",\n      \"MessageCategory\":\"Abort\",\n      \"MessageType\":\"Request\",\n      \"SaleID\":\"POSSystemID12345\",\n      \"ServiceID\":\"29239\",\n      \"POIID\":\"V400m-324688179\"\n    },\n    \"AbortRequest\":{\n      \"AbortReason\":\"MerchantAbort\",\n      \"MessageReference\":{\n        \"MessageCategory\":\"Payment\",\n        \"SaleID\":\"POSSystemID12345\",\n        \"ServiceID\":\"21796\"\n      }\n    }\n  }\n}<\/code><\/pre>\n<p>Nenhuma resposta da API \u00e9 gerada para a solicita\u00e7\u00e3o de cancelamento. Voc\u00ea recebe apenas uma HTTP <code>200 OK<\/code>.<\/p>\n<p>Se o cancelamento foi bem-sucedido:<\/p>\n<ul>\n<li>O terminal exibe a mensagem <strong>Cancelled<\/strong> na tela.<\/li>\n<li>\n<p>A <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment\/#step-3-make-a-payment\">solicita\u00e7\u00e3o de pagamento<\/a> retorna uma resposta contendo:<\/p>\n<ul>\n<li><code>Result<\/code>: <strong>Failure<\/strong><\/li>\n<li>\n<p><code>ErrorCondition<\/code>: <strong>Aborted<\/strong><\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Para verificar novamente se o pagamento foi realmente cancelado, fa\u00e7a uma <code>TransactionStatusRequest<\/code>.<\/p>\n<ul>\n<li>\n<p>Siga as instru\u00e7\u00f5es em <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/verify-transaction-status\">Verificar status da transa\u00e7\u00e3o<\/a>, especificando:<\/p>\n<ul>\n<li><code>MessageReference.SaleID<\/code>: A <code>SaleID<\/code> da caixa tregistradora que efetuou a transa\u00e7\u00e3o de pagamento que voc\u00ea tentou cancelar.<\/li>\n<li><code>MessageReference.ServiceID<\/code>: A <code>ServiceID<\/code> da transa\u00e7\u00e3o de pagamento que voc\u00ea tentou cancelar.<\/li>\n<li><code>MessageReference.MessageCategory<\/code>: <strong>Payment<\/strong><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>O exemplo abaixo mostra como voc\u00ea verificaria o status da transa\u00e7\u00e3o de um pagamento com <code>ServiceID<\/code> <strong>21796<\/strong>, que voc\u00ea tentou cancelar.<\/p>\n<pre><code class=\"language-json\">{\n  \"SaleToPOIRequest\": {\n    \"MessageHeader\": {\n      \"ProtocolVersion\": \"3.0\",\n      \"MessageClass\": \"Service\",\n      \"MessageCategory\": \"TransactionStatus\",\n      \"MessageType\": \"Request\",\n      \"SaleID\": \"POSSystemID12345\",\n      \"ServiceID\": \"29240\",\n      \"POIID\": \"V400m-324688179\"\n    },\n    \"TransactionStatusRequest\": {\n      \"ReceiptReprintFlag\": true,\n      \"DocumentQualifier\": [\n        \"CashierReceipt\",\n        \"CustomerReceipt\"\n      ],\n      \"MessageReference\": {\n        \"SaleID\": \"POSSystemID12345\",\n        \"ServiceID\": \"21796\",\n        \"MessageCategory\": \"Payment\"\n      }\n    }\n  }\n}<\/code><\/pre>\n<p>Se o pagamento foi cancelado, voc\u00ea dever\u00e1 receber uma resposta de <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/verify-transaction-status#transaction-not-found\">transa\u00e7\u00e3o n\u00e3o encontrada<\/a>. A <code>TransactionStatusResponse.Response<\/code> tem um <code>ErrorCondition<\/code> de <strong>NotFound<\/strong>.<\/p>\n<\/li>\n<\/ol>\n<h2 id=\"cancel-from-terminal\">Cancele um pagamento do terminal<\/h2>\n<p>Para cancelar um pagamento em andamento de um terminal:<\/p>\n<ol>\n<li>Pressione o bot\u00e3o <img src=\"\/point-of-sale\/basic-tapi-integration\/cancel-a-transaction\/cancel_2x.png\" alt=\"\" \/> no teclado do terminal.<\/li>\n<li>Na tela do terminal, confirme que deseja cancelar a transa\u00e7\u00e3o.<\/li>\n<\/ol>\n<p>Se bem-sucedido:<\/p>\n<ul>\n<li>O terminal exibe uma mensagem  <strong>Cancelled<\/strong> na tela.<\/li>\n<li>A <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment\/#step-3-make-a-payment\">soilicita\u00e7\u00e3o de pagamento<\/a> retorna uma resposta contendo:\n<ul>\n<li><code>Result<\/code>: <strong>Failure<\/strong><\/li>\n<li><code>ErrorCondition<\/code>: <strong>Cancel<\/strong><\/li>\n<\/ul><\/li>\n<\/ul>\n<h2>Lidando com falhas na solicita\u00e7\u00e3o de cancelamento<\/h2>\n<p>Se sua solicita\u00e7\u00e3o de cancelamento falhou (e o pagamento foi <strong>aprovado<\/strong>), voc\u00ea precisar\u00e1 reembolsar o pagamento. Para obter mais informa\u00e7\u00f5es sobre o reembolso de um pagamento, consulte <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/refund-payment\">Reembolsar um pagamento conclu\u00eddo<\/a>.<\/p>","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/basic-tapi-integration\/cancel-a-transaction","articleFields":{"description":"Saiba como cancelar uma transa\u00e7\u00e3o em andamento.","next_steps":[{"title":"Reembolsar um pagamento","description":"Saiba como reembolsar um pagamento conclu\u00eddo.","url":"\/point-of-sale\/basic-tapi-integration\/refund-payment","required":false},{"title":"Verificar status do pagamento","description":"Verifique o status de uma transa\u00e7\u00e3o quando voc\u00ea n\u00e3o receber uma resposta.","url":"\/point-of-sale\/basic-tapi-integration\/verify-transaction-status","required":false}],"id":"28875227","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"04-06-2020 17:43"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/basic-tapi-integration\/cancel-a-transaction","title":"Cancele um pagamento","content":"\nDeseja cancelar um pagamento j\u00e1 autorizado?Se voc\u00ea estiver usando captura com atraso ou captura manual em vez da captura autom\u00e1tica, voc\u00ea poder\u00e1 cancelar uma autoriza\u00e7\u00e3o\n\n\u00c0s vezes, os clientes mudam de id\u00e9ia no meio da compra ou os funcion\u00e1rios da loja percebem que cometeram um erro enquanto o comprador estava usando o terminal.\nUma solicita\u00e7\u00e3o de cancelamento permite que um cliente ou a equipe da loja aborte um pagamento em andamento. Quando o pedido de cancelamento \u00e9 recebido antes de o pagamento ser aprovado , o pagamento \u00e9 cancelado.\nAqui explicamos como os pagamentos podem ser cancelados:\n\nDe sua caixa refgistradora\nDe seu termianl\n\nCancele um pagamento de sua caixa registradora\nEnquanto  a solicita\u00e7\u00e3o de pagamento estiver em andamento, voc\u00ea poder\u00e1 cancel\u00e1-la fazendo uma solicita\u00e7\u00e3o de cancelamento na sua caixa registradora.\n\n\nPara cancelar um pagamento, fa\u00e7a uma solicita\u00e7\u00e3o POST para o endpoint da API de Terminais, especificando:\n\n\nObejto MessageHeader. Este segue a estrutura MessageHeader padr\u00e3o, explicada nos fundamentos da API de terminais:\n\nProtocolVersion: 3.0\nMessageClass: Service\nMessageCategory: Abort.\nMessageType: Request\nSaleID: Seu ID exclusivo para a caixa registradora que faz o pedido de cancelamento.\nServiceID: Seu ID exclusivo para esta tentativa de transa\u00e7\u00e3o, consistindo em 1 a 10 caracteres alfanum\u00e9ricos. Esse valor deve ser exclusivo nas \u00faltimas 48 horas.\n\nPOIID: ID exclusivo do terminal. Isso indica para qual terminal o pagamento ser\u00e1 roteado.\n\n\n\n\n\nObjeto  AbortRequest com:\n\nAbortReason: MerchantAbort\nMessageReference.MessageCategory: Payment\nMessageReference.SaleID: Seu ID exclusivo da caixa registradora que fez a solicita\u00e7\u00e3o de pagamento.\nMessageReference.ServiceID: A solicita\u00e7\u00e3o ServiceID do pagamento est\u00e1 sendo cancelada.\n\n\n\nO exemplo abaixo mostra como voc\u00ea faria uma solicita\u00e7\u00e3o para cancelar um pagamento em andamento com um valor ServiceID de 21796.\n{\n  \"SaleToPOIRequest\":{\n    \"MessageHeader\":{\n      \"ProtocolVersion\":\"3.0\",\n      \"MessageClass\":\"Service\",\n      \"MessageCategory\":\"Abort\",\n      \"MessageType\":\"Request\",\n      \"SaleID\":\"POSSystemID12345\",\n      \"ServiceID\":\"29239\",\n      \"POIID\":\"V400m-324688179\"\n    },\n    \"AbortRequest\":{\n      \"AbortReason\":\"MerchantAbort\",\n      \"MessageReference\":{\n        \"MessageCategory\":\"Payment\",\n        \"SaleID\":\"POSSystemID12345\",\n        \"ServiceID\":\"21796\"\n      }\n    }\n  }\n}\nNenhuma resposta da API \u00e9 gerada para a solicita\u00e7\u00e3o de cancelamento. Voc\u00ea recebe apenas uma HTTP 200 OK.\nSe o cancelamento foi bem-sucedido:\n\nO terminal exibe a mensagem Cancelled na tela.\n\nA solicita\u00e7\u00e3o de pagamento retorna uma resposta contendo:\n\nResult: Failure\n\nErrorCondition: Aborted\n\n\n\n\n\n\n\nPara verificar novamente se o pagamento foi realmente cancelado, fa\u00e7a uma TransactionStatusRequest.\n\n\nSiga as instru\u00e7\u00f5es em Verificar status da transa\u00e7\u00e3o, especificando:\n\nMessageReference.SaleID: A SaleID da caixa tregistradora que efetuou a transa\u00e7\u00e3o de pagamento que voc\u00ea tentou cancelar.\nMessageReference.ServiceID: A ServiceID da transa\u00e7\u00e3o de pagamento que voc\u00ea tentou cancelar.\nMessageReference.MessageCategory: Payment\n\n\n\nO exemplo abaixo mostra como voc\u00ea verificaria o status da transa\u00e7\u00e3o de um pagamento com ServiceID 21796, que voc\u00ea tentou cancelar.\n{\n  \"SaleToPOIRequest\": {\n    \"MessageHeader\": {\n      \"ProtocolVersion\": \"3.0\",\n      \"MessageClass\": \"Service\",\n      \"MessageCategory\": \"TransactionStatus\",\n      \"MessageType\": \"Request\",\n      \"SaleID\": \"POSSystemID12345\",\n      \"ServiceID\": \"29240\",\n      \"POIID\": \"V400m-324688179\"\n    },\n    \"TransactionStatusRequest\": {\n      \"ReceiptReprintFlag\": true,\n      \"DocumentQualifier\": [\n        \"CashierReceipt\",\n        \"CustomerReceipt\"\n      ],\n      \"MessageReference\": {\n        \"SaleID\": \"POSSystemID12345\",\n        \"ServiceID\": \"21796\",\n        \"MessageCategory\": \"Payment\"\n      }\n    }\n  }\n}\nSe o pagamento foi cancelado, voc\u00ea dever\u00e1 receber uma resposta de transa\u00e7\u00e3o n\u00e3o encontrada. A TransactionStatusResponse.Response tem um ErrorCondition de NotFound.\n\n\nCancele um pagamento do terminal\nPara cancelar um pagamento em andamento de um terminal:\n\nPressione o bot\u00e3o  no teclado do terminal.\nNa tela do terminal, confirme que deseja cancelar a transa\u00e7\u00e3o.\n\nSe bem-sucedido:\n\nO terminal exibe uma mensagem  Cancelled na tela.\nA soilicita\u00e7\u00e3o de pagamento retorna uma resposta contendo:\n\nResult: Failure\nErrorCondition: Cancel\n\n\nLidando com falhas na solicita\u00e7\u00e3o de cancelamento\nSe sua solicita\u00e7\u00e3o de cancelamento falhou (e o pagamento foi aprovado), voc\u00ea precisar\u00e1 reembolsar o pagamento. Para obter mais informa\u00e7\u00f5es sobre o reembolso de um pagamento, consulte Reembolsar um pagamento conclu\u00eddo.","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Implement the payment flow","lvl3":"Cancele um pagamento"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/basic-tapi-integration","lvl3":"\/pt\/point-of-sale\/basic-tapi-integration\/cancel-a-transaction"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Cancele","pagamento"]},"articleFiles":{"abort-payment-request.json":"<p alt=\"\">abort-payment-request.json<\/p>"}}