{"title":"Efetue um pagamento b\u00e1sico","category":"default","creationDate":1776961627,"content":"<p>Esta p\u00e1gina explica o processo de configura\u00e7\u00e3o para efetuar um pagamento b\u00e1sico com cart\u00e3o usando a Terminal API da Adyen. A partir daqui, \u00e9 poss\u00edvel criar uma integra\u00e7\u00e3o que suporte os m\u00e9todos de pagamento via NFC e carteira digital, permitindo que os clientes paguem em sua pr\u00f3pria moeda ou criar uma <a href=\"\/pt\/point-of-sale\/tokenize-shopper-data-for-shopper-recognition\">experi\u00eancia omnichannel<\/a> para o cliente.<\/p>\n<p>O terminal e a frente de caixa se comunicam usando mensagens JSON, que s\u00e3o transmitidas atrav\u00e9s de uma rede local ou baseada em nuvem, dependendo da sua <a href=\"\/pt\/point-of-sale\">escolha de arquitetura<\/a>.<\/p>\n<p>Antes de aceitar pagamentos em tempo real, recomendamos que voc\u00ea <a href=\"\/pt\/point-of-sale\/testing-pos-payments\">teste a integra\u00e7\u00e3o do seu ponto de venda<\/a>.\u00a0<\/p>\n<div class=\"sc-notice note\"><div>\n<p>Se voc\u00ea estiver usando comunica\u00e7\u00e3o local, tamb\u00e9m precisar\u00e1 <a href=\"#encrypting-local-communications\">configurar a criptografia<\/a> antes de poder aceitar pagamentos em tempo real.<\/p>\n<\/div><\/div>\n<h2 id=\"before-you-begin\">Antes de come\u00e7ar<\/h2>\n<p>Antes de iniciar a integra\u00e7\u00e3o com a nossa Terminal API e realizar o seu primeiro pagamento com o terminal, certifique-se de ter executado os seguintes passos:<\/p>\n<ol>\n<li>Inscri\u00e7\u00e3o para ter uma conta de teste da Adyen na p\u00e1gina\u00a0<a href=\"https:\/\/www.adyen.com\/signup\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">https:\/\/www.adyen.com\/signup<\/a>.<\/li>\n<li><a href=\"\/pt\/point-of-sale\/managing-terminals\/order-terminals\">Encomende terminal e cart\u00e3o de testes<\/a>.<\/li>\n<li><a href=\"\/pt\/point-of-sale\/user-manuals\/board-the-terminal\">Ative o terminal<\/a>.<\/li>\n<li>Se voc\u00ea estiver usando comuni\u00e7\u00e3o em nuvem, <a href=\"\/pt\/user-management\/how-to-get-the-api-key\/#description\">gere uma chave da API<\/a>.<\/li>\n<\/ol>\n<p>Para obter mais informa\u00e7\u00f5es sobre integra\u00e7\u00e3o com a Adyen, consulte a <a href=\"\/pt\/get-started-with-adyen\">Introdu\u00e7\u00e3o \u00e0 Adyen<\/a>.<\/p>\n<h2 id=\"make-a-payment\">Efetue um pagamento<\/h2>\n<p>O terminal e a frente de caixa se comunicam por meio de mensagens JSON. Para iniciar um pagamento, fa\u00e7a uma solicita\u00e7\u00e3o JSON na sua frente de caixa. Ela \u00e9 roteada para o terminal, onde o cliente pode apresentar o seu cart\u00e3o e concluir o pagamento.<\/p>\n<p>Para iniciar o pagamento:<\/p>\n<ol>\n<li>\n<p>Fa\u00e7a uma solicita\u00e7\u00e3o POST para um <a href=\"#terminal-api-endpoints\">endpoint da Terminal API<\/a>, especificando:<\/p>\n<ul>\n<li><code>content-type<\/code>: <strong>application\/json<\/strong><\/li>\n<li><code>x-api-key<\/code>: A chave da API que voc\u00ea <a href=\"#before-you-begin\">gerou anteriormente<\/a>.\u00a0\n<div class=\"sc-notice note\"><div>\n<p>Uma chave da API s\u00f3 \u00e9 necess\u00e1ria se estiver sendo usada comunica\u00e7\u00e3o em nuvem.<\/p>\n<\/div><\/div><\/li>\n<li><code>ProtocolVersion<\/code>: <strong>3.0<\/strong><\/li>\n<li><code>MessageCategory<\/code>: <strong>Payment<\/strong><\/li>\n<li><code>MessageType<\/code>: <strong>Request<\/strong><\/li>\n<li><code>SaleID<\/code>: A sua ID exclusiva para a frente de caixa.<\/li>\n<li><code>ServiceID<\/code>: A sua ID exclusiva gerada pela frente de caixa para essa transa\u00e7\u00e3o. Esse valor deve ser \u00fanico nas \u00faltimas 48 horas.<\/li>\n<li><code>POIID<\/code>: ID exclusiva do terminal.\u00a0\n<div class=\"sc-notice info\"><div>\n<p>O <code>POIID<\/code> = <em>[Modelo do terminal]-[N\u00famero de s\u00e9rie]<\/em>, por exemplo: <strong>P400Plus-123456789<\/strong><\/p>\n<\/div><\/div><\/li>\n<li><code>TransactionID<\/code>: A sua refer\u00eancia exclusiva para essa transa\u00e7\u00e3o.<\/li>\n<li><code>TimeStamp<\/code>: Data e hora da transa\u00e7\u00e3o.<\/li>\n<li><code>AmountsReq<\/code>: A moeda <code>Currency<\/code>e o valor (<code>RequestedAmount<\/code>) da transa\u00e7\u00e3o.<\/li>\n<\/ul>\n<p>O exemplo abaixo ilustra como voc\u00ea faria um pagamento de EUR 10,99 usando comunica\u00e7\u00e3o s\u00edncrona em nuvem.<\/p>\n<pre><code class=\"language-bash\">curl -H \"content-type:application\/json\" -H 'x-api-key:ADYEN_API_KEY' -X POST --data-binary '{\n  \"SaleToPOIRequest\":{\n    \"MessageHeader\":{\n      \"ProtocolVersion\":\"3.0\",\n      \"MessageClass\":\"Service\",\n      \"MessageCategory\":\"Payment\",\n      \"MessageType\":\"Request\",\n      \"SaleID\":\"POSSystemID12345\",\n      \"ServiceID\":\"0207111104\",\n      \"POIID\":\"V400m-324688179\"\n    },\n    \"PaymentRequest\":{\n      \"SaleData\":{\n        \"SaleTransactionID\":{\n          \"TransactionID\":\"27908\",\n          \"TimeStamp\":\"2019-03-07T10:11:04+00:00\"\n        }\n      },\n      \"PaymentTransaction\":{\n        \"AmountsReq\":{\n          \"Currency\":\"EUR\",\n          \"RequestedAmount\":10.99\n        }\n      }\n    }\n  }\n}' --url https:\/\/terminal-api-test.adyen.com\/sync<\/code><\/pre>\n<div class=\"sc-notice info\"><div>\n<p>Para ter acesso a uma lista completa dos campos que voc\u00ea pode enviar em uma solicita\u00e7\u00e3o de pagamento, 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<p>A solicita\u00e7\u00e3o \u00e9 encaminhada para o terminal, para que o cliente conclua a opera\u00e7\u00e3o.<\/p>\n<\/li>\n<li>\n<p>Insira o cart\u00e3o de testes no terminal.<\/p>\n<\/li>\n<li>\n<p>Siga as instru\u00e7\u00f5es no terminal para concluir a transa\u00e7\u00e3o.<\/p>\n<div class=\"notices blue\">\n<p>O PIN padr\u00e3o do cart\u00e3o de teste \u00e9 1234.<\/p>\n<\/div>\n<\/li>\n<\/ol>\n<p>Se o pagamento for bem sucedido: <a id=\"payment-response\"><\/a><\/p>\n<ul>\n<li><strong>Aprovado<\/strong> ser\u00e1 exibido na tela do terminal.<\/li>\n<li>\n<p>Voc\u00ea recebe uma resposta JSON com:<\/p>\n<ul>\n<li><code>AdditionalResponse<\/code>: Cont\u00e9m um valor\u00a0<code>pspReference<\/code>, que \u00e9 nosso identificador exclusivo para essa transa\u00e7\u00e3o.<\/li>\n<li><code>Result<\/code>: <strong>Success<\/strong><\/li>\n<\/ul>\n<pre><code class=\"language-json\">{\n  \"SaleToPOIResponse\":{\n    \"PaymentResponse\":{\n      \"Response\":{\n        \"AdditionalResponse\":\"...pspReference=NC6HT9CRT65ZGN82...\",\n        \"Result\":\"Success\"\n      },\n    {...}\n  }\n}<\/code><\/pre>\n<div class=\"notices blue\">\n<p>Para ter acesso a uma lista completa dos campos que voc\u00ea pode receber em uma resposta de pagamento, consulte a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/payment#responses-200\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">PaymentResponse<\/a>.<\/p>\n<\/div>\n<\/li>\n<\/ul>\n<p>Voc\u00ea encontrar\u00e1 mais detalhes do pagamento na sua <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, em <strong>Transactions<\/strong> &gt; <strong>Payments<\/strong>.<\/p>\n<h2 id=\"terminal-api-endpoints\">Terminal API endpoints<\/h2>\n<p>Para mais informa\u00e7\u00f5es, consulte <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api#endpoints-and-authentication\">endpoints e autentica\u00e7\u00e3o<\/a>.<\/p>\n<h2 id=\"encrypting-local-communications\">Criptografia de comunica\u00e7\u00f5es locais<\/h2>\n<p>Se a sua frente de caixa tiver uma conex\u00e3o local com o terminal, ser\u00e1 necess\u00e1rio criptografar todas as comunica\u00e7\u00f5es entre esses dispositivos. Isso n\u00e3o \u00e9 uma exig\u00eancia para a realiza\u00e7\u00e3o de testes de pagamentos, mas dever\u00e1 ser configurado antes que voc\u00ea aceite pagamentos reais.<\/p>\n<p>Para mais informa\u00e7\u00f5es, consulte <a href=\"\/pt\/point-of-sale\/secure-local-communications\">comunica\u00e7\u00f5es locais seguras<\/a>.<\/p>","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment","articleFields":{"description":"Fa\u00e7a um pagamento b\u00e1sico com cart\u00e3o usando a nossa Terminal API.","next_steps":[{"title":"Reembolsar um pagamento","description":"Saiba como emitir um reembolso.","url":"\/point-of-sale\/basic-tapi-integration\/refund-payment","required":false},{"title":"Captura com atraso","description":"Aprenda a usar um atraso de captura.","url":"\/point-of-sale\/capturing-payments\/delayed-capture","required":false},{"title":"Verificar status da transa\u00e7\u00e3o","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":"28871688","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"28-05-2020 18:14"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment","title":"Efetue um pagamento b\u00e1sico","content":"Esta p\u00e1gina explica o processo de configura\u00e7\u00e3o para efetuar um pagamento b\u00e1sico com cart\u00e3o usando a Terminal API da Adyen. A partir daqui, \u00e9 poss\u00edvel criar uma integra\u00e7\u00e3o que suporte os m\u00e9todos de pagamento via NFC e carteira digital, permitindo que os clientes paguem em sua pr\u00f3pria moeda ou criar uma experi\u00eancia omnichannel para o cliente.\nO terminal e a frente de caixa se comunicam usando mensagens JSON, que s\u00e3o transmitidas atrav\u00e9s de uma rede local ou baseada em nuvem, dependendo da sua escolha de arquitetura.\nAntes de aceitar pagamentos em tempo real, recomendamos que voc\u00ea teste a integra\u00e7\u00e3o do seu ponto de venda.\u00a0\n\nSe voc\u00ea estiver usando comunica\u00e7\u00e3o local, tamb\u00e9m precisar\u00e1 configurar a criptografia antes de poder aceitar pagamentos em tempo real.\n\nAntes de come\u00e7ar\nAntes de iniciar a integra\u00e7\u00e3o com a nossa Terminal API e realizar o seu primeiro pagamento com o terminal, certifique-se de ter executado os seguintes passos:\n\nInscri\u00e7\u00e3o para ter uma conta de teste da Adyen na p\u00e1gina\u00a0https:\/\/www.adyen.com\/signup.\nEncomende terminal e cart\u00e3o de testes.\nAtive o terminal.\nSe voc\u00ea estiver usando comuni\u00e7\u00e3o em nuvem, gere uma chave da API.\n\nPara obter mais informa\u00e7\u00f5es sobre integra\u00e7\u00e3o com a Adyen, consulte a Introdu\u00e7\u00e3o \u00e0 Adyen.\nEfetue um pagamento\nO terminal e a frente de caixa se comunicam por meio de mensagens JSON. Para iniciar um pagamento, fa\u00e7a uma solicita\u00e7\u00e3o JSON na sua frente de caixa. Ela \u00e9 roteada para o terminal, onde o cliente pode apresentar o seu cart\u00e3o e concluir o pagamento.\nPara iniciar o pagamento:\n\n\nFa\u00e7a uma solicita\u00e7\u00e3o POST para um endpoint da Terminal API, especificando:\n\ncontent-type: application\/json\nx-api-key: A chave da API que voc\u00ea gerou anteriormente.\u00a0\n\nUma chave da API s\u00f3 \u00e9 necess\u00e1ria se estiver sendo usada comunica\u00e7\u00e3o em nuvem.\n\nProtocolVersion: 3.0\nMessageCategory: Payment\nMessageType: Request\nSaleID: A sua ID exclusiva para a frente de caixa.\nServiceID: A sua ID exclusiva gerada pela frente de caixa para essa transa\u00e7\u00e3o. Esse valor deve ser \u00fanico nas \u00faltimas 48 horas.\nPOIID: ID exclusiva do terminal.\u00a0\n\nO POIID = [Modelo do terminal]-[N\u00famero de s\u00e9rie], por exemplo: P400Plus-123456789\n\nTransactionID: A sua refer\u00eancia exclusiva para essa transa\u00e7\u00e3o.\nTimeStamp: Data e hora da transa\u00e7\u00e3o.\nAmountsReq: A moeda Currencye o valor (RequestedAmount) da transa\u00e7\u00e3o.\n\nO exemplo abaixo ilustra como voc\u00ea faria um pagamento de EUR 10,99 usando comunica\u00e7\u00e3o s\u00edncrona em nuvem.\ncurl -H \"content-type:application\/json\" -H 'x-api-key:ADYEN_API_KEY' -X POST --data-binary '{\n  \"SaleToPOIRequest\":{\n    \"MessageHeader\":{\n      \"ProtocolVersion\":\"3.0\",\n      \"MessageClass\":\"Service\",\n      \"MessageCategory\":\"Payment\",\n      \"MessageType\":\"Request\",\n      \"SaleID\":\"POSSystemID12345\",\n      \"ServiceID\":\"0207111104\",\n      \"POIID\":\"V400m-324688179\"\n    },\n    \"PaymentRequest\":{\n      \"SaleData\":{\n        \"SaleTransactionID\":{\n          \"TransactionID\":\"27908\",\n          \"TimeStamp\":\"2019-03-07T10:11:04+00:00\"\n        }\n      },\n      \"PaymentTransaction\":{\n        \"AmountsReq\":{\n          \"Currency\":\"EUR\",\n          \"RequestedAmount\":10.99\n        }\n      }\n    }\n  }\n}' --url https:\/\/terminal-api-test.adyen.com\/sync\n\nPara ter acesso a uma lista completa dos campos que voc\u00ea pode enviar em uma solicita\u00e7\u00e3o de pagamento, consulte a  PaymentRequest.\n\nA solicita\u00e7\u00e3o \u00e9 encaminhada para o terminal, para que o cliente conclua a opera\u00e7\u00e3o.\n\n\nInsira o cart\u00e3o de testes no terminal.\n\n\nSiga as instru\u00e7\u00f5es no terminal para concluir a transa\u00e7\u00e3o.\n\nO PIN padr\u00e3o do cart\u00e3o de teste \u00e9 1234.\n\n\n\nSe o pagamento for bem sucedido: \n\nAprovado ser\u00e1 exibido na tela do terminal.\n\nVoc\u00ea recebe uma resposta JSON com:\n\nAdditionalResponse: Cont\u00e9m um valor\u00a0pspReference, que \u00e9 nosso identificador exclusivo para essa transa\u00e7\u00e3o.\nResult: Success\n\n{\n  \"SaleToPOIResponse\":{\n    \"PaymentResponse\":{\n      \"Response\":{\n        \"AdditionalResponse\":\"...pspReference=NC6HT9CRT65ZGN82...\",\n        \"Result\":\"Success\"\n      },\n    {...}\n  }\n}\n\nPara ter acesso a uma lista completa dos campos que voc\u00ea pode receber em uma resposta de pagamento, consulte a  PaymentResponse.\n\n\n\nVoc\u00ea encontrar\u00e1 mais detalhes do pagamento na sua Customer Area, em Transactions &gt; Payments.\nTerminal API endpoints\nPara mais informa\u00e7\u00f5es, consulte endpoints e autentica\u00e7\u00e3o.\nCriptografia de comunica\u00e7\u00f5es locais\nSe a sua frente de caixa tiver uma conex\u00e3o local com o terminal, ser\u00e1 necess\u00e1rio criptografar todas as comunica\u00e7\u00f5es entre esses dispositivos. Isso n\u00e3o \u00e9 uma exig\u00eancia para a realiza\u00e7\u00e3o de testes de pagamentos, mas dever\u00e1 ser configurado antes que voc\u00ea aceite pagamentos reais.\nPara mais informa\u00e7\u00f5es, consulte comunica\u00e7\u00f5es locais seguras.","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Implement the payment flow","lvl3":"Efetue um pagamento b\u00e1sico"},"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\/make-a-payment"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Efetue","pagamento","b\u00e1sico"]},"articleFiles":{"approved-response.json":"<p alt=\"\">approved-response.json<\/p>","declined-response.json":"<p alt=\"\">declined-response.json<\/p>","make-a-payment_0.json":"<p alt=\"\">make-a-payment_0.json<\/p>","screen-EN_approved.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/03.point-of-sale\/05.basic-tapi-integration\/01.make-a-payment\/screen-EN_approved.svg\" \/>","screen-EN_authorizing.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/03.point-of-sale\/05.basic-tapi-integration\/01.make-a-payment\/screen-EN_authorizing.svg\" \/>","screen-EN_payment.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/03.point-of-sale\/05.basic-tapi-integration\/01.make-a-payment\/screen-EN_payment.svg\" \/>"}}