{"title":"Venda digitada (MKE)","category":"default","creationDate":1776961627,"content":"<p>Vendas digitadas (MKE - Manual Keyed Entry) envolvem digitar manualmente os detalhes do cart\u00e3o de um cliente no terminal. Voc\u00ea pode us\u00e1-lo quando o terminal de pagamento n\u00e3o obtiver os detalhes do cart\u00e3o no chip ou na tarja magn\u00e9tica do cart\u00e3o.<\/p>\n<div class=\"sc-notice note\"><div>\n<p>N\u00e3o h\u00e1 mudan\u00e7a de responsabilidade com o MKE. Isso significa que voc\u00ea \u00e9 totalmente respons\u00e1vel por <a href=\"\/pt\/point-of-sale\/what-we-support\/payment-methods#pos-chargebacks\">estornos de fraude<\/a>.<\/p>\n<\/div><\/div>\n<h2>Como funciona<\/h2>\n<ol>\n<li>Quando o terminal de pagamento n\u00e3o consegue ler os detalhes do cart\u00e3o, voc\u00ea <a href=\"#request\">inicia uma transa\u00e7\u00e3o MKE<\/a> partir da sua caixa registradora.<\/li>\n<li>O terminal solicita ao cliente que insira manualmente os detalhes do cart\u00e3o.<\/li>\n<li>O terminal solicita ao cliente que forne\u00e7a sua assinatura no visor.<\/li>\n<li>A transa\u00e7\u00e3o continua.<\/li>\n<\/ol>\n<h2 id=\"configure-mke\">Configurar transa\u00e7\u00f5es MKE<\/h2>\n<p>Devido ao risco aumentado de estornos, voc\u00ea precisa executar uma a\u00e7\u00e3o antes de poder usar o MKE:<\/p>\n<ol>\n<li>Entre em contato com nossa <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> e solicite a ativa\u00e7\u00e3o da entrada com chave manual para voc\u00ea.<\/li>\n<li>\n<p>Defina uma quantidade m\u00e1xima que o terminal permitir\u00e1 para uma transa\u00e7\u00e3o MKE:<\/p>\n<ol>\n<li>Fa\u00e7a o login em sua <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/li>\n<li>V\u00e1 para <strong>In-person payments<\/strong> &gt; <strong>Global properties<\/strong> ou selecione um terminal espec\u00edfico.<\/li>\n<li>Na guia <strong>Currencies &amp; amounts<\/strong> insira o <strong>MKE max amount (valor m\u00e1ximo MKE)<\/strong>.<\/li>\n<li>\n<p>Selecione <strong>Save<\/strong>.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<h2 id=\"request\">Efetuar um pagamento MKE<\/h2>\n<p>Usando uma condi\u00e7\u00e3o de transa\u00e7\u00e3o, voc\u00ea pode for\u00e7ar o MKE como o <a href=\"\/pt\/get-started-with-adyen\/adyen-glossary\/#point-of-sale-entry-mode\">modo de entrada do cart\u00e3o<\/a>.<\/p>\n<ol>\n<li>\n<p>Fa\u00e7a uma chamada <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment\">\n  <code>PaymentRequest<\/code>\n<\/a> para a API de terminais, especificando uma <code>PaymentTransaction<\/code> que cont\u00e9m:<\/p>\n<ul>\n<li>\n<p><code>TransactionConditions.ForceEntryMode<\/code>: <strong>Keyed<\/strong><\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<div class=\"sc-notice info\"><div>\n<p>Para obter uma lista completa dos campos, voc\u00ea pode passar uma solicita\u00e7\u00e3o de pagamento e receber a resposta, consulte a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/payment\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">PaymentRequest<\/a>.<\/p>\n<\/div><\/div>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"''\" :id=\"'manual-keyed-entry_1'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{\\n    \\\"SaleToPOIRequest\\\":{\\n        \\\"MessageHeader\\\":{\\n            \\\"ProtocolVersion\\\":\\\"3.0\\\",\\n            \\\"MessageClass\\\":\\\"Service\\\",\\n            \\\"MessageCategory\\\":\\\"Payment\\\",\\n            \\\"MessageType\\\":\\\"Request\\\",\\n            \\\"ServiceID\\\":\\\"037\\\",\\n            \\\"SaleID\\\":\\\"POSSystemID12345\\\",\\n            \\\"POIID\\\":\\\"P400Plus-275040702\\\"\\n        },\\n        \\\"PaymentRequest\\\":{\\n            \\\"SaleData\\\":{\\n                \\\"SaleToAcquirerData\\\":\\\"\\\",\\n                \\\"SaleTransactionID\\\":{\\n                    \\\"TransactionID\\\":\\\"8377PME_POS\\\",\\n                    \\\"TimeStamp\\\":\\\"2021-01-19T11:03:39.000Z\\\"\\n                }\\n            },\\n            \\\"PaymentTransaction\\\":{\\n                \\\"AmountsReq\\\":{\\n                    \\\"RequestedAmount\\\":17.50,\\n                    \\\"Currency\\\":\\\"EUR\\\"\\n                },\\n                \\\"TransactionConditions\\\":{\\n                    \\\"ForceEntryMode\\\":[\\n                        \\\"Keyed\\\"\\n                    ]\\n                }\\n            }\\n        }\\n    }\\n}\"},{\"language\":\"java\",\"tabTitle\":\"Java\",\"content\":\"String POIID = \\\"YOUR_TERMINAL_ID\\\";\\nString serviceID = \\\"YOUR_UNIQUE_ATTEMPT_ID\\\";\\nString saleID = \\\"YOUR_CASH_REGISTER_ID\\\";\\nString transactionID = \\\"YOUR_UNIQUE_TRANSACTION_ID\\\";\\n\\nSaleToPOIRequest saleToPOIRequest = new SaleToPOIRequest();\\nMessageHeader messageHeader = new MessageHeader();\\nmessageHeader.setPOIID(POIID);\\nmessageHeader.setMessageClass( MessageClassType.SERVICE );\\nmessageHeader.setMessageType( MessageType.REQUEST );\\nmessageHeader.setProtocolVersion(\\\"3.0\\\");\\nmessageHeader.setServiceID(serviceID);\\nmessageHeader.setSaleID(saleID);\\nmessageHeader.setMessageCategory( MessageCategoryType.PAYMENT );\\nsaleToPOIRequest.setMessageHeader(messageHeader);\\n\\nPaymentRequest paymentRequest = new PaymentRequest();\\nPaymentTransaction paymentTransaction = new PaymentTransaction();\\nAmountsReq amountsReq = new AmountsReq();\\namountsReq.setRequestedAmount( BigDecimal.valueOf(17.5) );\\namountsReq.setCurrency(\\\"EUR\\\");\\npaymentTransaction.setAmountsReq(amountsReq);\\n\\nTransactionConditions transactionConditions = new TransactionConditions();\\ntransactionConditions.getForceEntryMode().add( ForceEntryModeType.KEYED );\\npaymentTransaction.setTransactionConditions(transactionConditions);\\npaymentRequest.setPaymentTransaction(paymentTransaction);\\n\\nSaleData saleData = new SaleData();\\nsaleData.setSaleToAcquirerData(\\\"\\\");\\nTransactionIdentification saleTransactionID = new TransactionIdentification();\\nsaleTransactionID.setTransactionID(transactionID);\\nsaleTransactionID.setTimeStamp(DatatypeFactory.newInstance().newXMLGregorianCalendar(new GregorianCalendar()));\\nsaleData.setSaleTransactionID(saleTransactionID);\\npaymentRequest.setSaleData(saleData);\\nsaleToPOIRequest.setPaymentRequest(paymentRequest);\\nterminalAPIRequest.setSaleToPOIRequest(saleToPOIRequest);\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>Na resposta, observe que <code>PaymentResult<\/code> inclui:<\/p>\n<ul>\n<li><code>CapturedSignature<\/code>: Pontos de coordenadas da assinatura desenhada no visor do terminal.<\/li>\n<li><code>AuthenticationMethod<\/code>: <strong>SignatureCapture<\/strong><\/li>\n<li><code>PaymentInstrumentData.CardData<\/code>: Indica que <code>EntryMode<\/code> foi <strong>Keyed<\/strong><\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h2>Veja tamb\u00e9m<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/point-of-sale\/what-we-support\/payment-methods#pos-chargebacks\"\n                        target=\"_self\"\n                        >\n                    Risco de estorno\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/enter-payment-manually","articleFields":{"description":" Manualmente os detalhes do cart\u00e3o para realizar um pagamento.","id":"28871701","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"03-06-2020 16:36"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/enter-payment-manually","title":"Venda digitada (MKE)","content":"Vendas digitadas (MKE - Manual Keyed Entry) envolvem digitar manualmente os detalhes do cart\u00e3o de um cliente no terminal. Voc\u00ea pode us\u00e1-lo quando o terminal de pagamento n\u00e3o obtiver os detalhes do cart\u00e3o no chip ou na tarja magn\u00e9tica do cart\u00e3o.\n\nN\u00e3o h\u00e1 mudan\u00e7a de responsabilidade com o MKE. Isso significa que voc\u00ea \u00e9 totalmente respons\u00e1vel por estornos de fraude.\n\nComo funciona\n\nQuando o terminal de pagamento n\u00e3o consegue ler os detalhes do cart\u00e3o, voc\u00ea inicia uma transa\u00e7\u00e3o MKE partir da sua caixa registradora.\nO terminal solicita ao cliente que insira manualmente os detalhes do cart\u00e3o.\nO terminal solicita ao cliente que forne\u00e7a sua assinatura no visor.\nA transa\u00e7\u00e3o continua.\n\nConfigurar transa\u00e7\u00f5es MKE\nDevido ao risco aumentado de estornos, voc\u00ea precisa executar uma a\u00e7\u00e3o antes de poder usar o MKE:\n\nEntre em contato com nossa Support Team e solicite a ativa\u00e7\u00e3o da entrada com chave manual para voc\u00ea.\n\nDefina uma quantidade m\u00e1xima que o terminal permitir\u00e1 para uma transa\u00e7\u00e3o MKE:\n\nFa\u00e7a o login em sua Customer Area.\nV\u00e1 para In-person payments &gt; Global properties ou selecione um terminal espec\u00edfico.\nNa guia Currencies &amp; amounts insira o MKE max amount (valor m\u00e1ximo MKE).\n\nSelecione Save.\n\n\n\n\n\nEfetuar um pagamento MKE\nUsando uma condi\u00e7\u00e3o de transa\u00e7\u00e3o, voc\u00ea pode for\u00e7ar o MKE como o modo de entrada do cart\u00e3o.\n\n\nFa\u00e7a uma chamada \n  PaymentRequest\n para a API de terminais, especificando uma PaymentTransaction que cont\u00e9m:\n\n\nTransactionConditions.ForceEntryMode: Keyed\n\n\n\n\nPara obter uma lista completa dos campos, voc\u00ea pode passar uma solicita\u00e7\u00e3o de pagamento e receber a resposta, consulte a  PaymentRequest.\n\n\n\n\n\n\nNa resposta, observe que PaymentResult inclui:\n\nCapturedSignature: Pontos de coordenadas da assinatura desenhada no visor do terminal.\nAuthenticationMethod: SignatureCapture\nPaymentInstrumentData.CardData: Indica que EntryMode foi Keyed\n\n\n\nVeja tamb\u00e9m\n\n\n                    Risco de estorno\n                \n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Venda digitada (MKE)"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"\/pt\/point-of-sale\/enter-payment-manually"},"levels":3,"category":"In-person payments","category_color":"green","tags":["Venda","digitada","(MKE)"]},"articleFiles":{"manual-keyed-entry_1.json":"<p alt=\"\">manual-keyed-entry_1.json<\/p>","manual-keyed-entry_1_response.json":"<p alt=\"\">manual-keyed-entry_1_response.json<\/p>"}}
