{"title":"Construa sua integra\u00e7\u00e3o com a API de Terminais","category":"default","creationDate":1776961627,"content":"<div class=\"additional-info-block output-inline\">\n<h5 class=\"article__heading additional-info-block__title\">Support<\/h5><div class=\"additional-info-block__body\"><p>Artigos, FAQs e solicita\u00e7\u00e3o de suporte: <a href=\"https:\/\/help.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Adyen Help<\/a><\/p><\/div><\/div>\n\n<p>Uma integra\u00e7\u00e3o com API de terminais da Adyen permite que voc\u00ea inicie os pagamentos de seu sistema de caixa registradora e processe esses pagamentos por meio da Adyen usando nossos terminais de pagamento.<\/p>\n<p>Aqui, descrevemos como voc\u00ea pode construir tal integra\u00e7\u00e3o em um ambiente de teste antes de ir ao ar.<\/p>\n<h2>Antes de voc\u00ea come\u00e7ar<\/h2>\n<ul>\n<li>Leia a vis\u00e3o geral dos <a href=\"\/pt\/get-started-with-adyen\">Primeiros passos com a Adyen<\/a> e inscreva-se para uma conta de teste.<\/li>\n<\/ul>\n<h2>Etapa 1: configure sua conta de teste da Adyen<\/h2>\n<p>Depois de se inscrever para uma conta de teste da Adyen, voc\u00ea tem acesso \u00e0 sua <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">test Customer Area<\/a>. Neste ambiente de teste, voc\u00ea precisa configurar uma estrutura para sua conta da Adyen. A estrutura mais adequada para voc\u00ea atende \u00e0s suas necessidades de neg\u00f3cios.<\/p>\n<ol>\n<li>\n<p>Determine a estrutura de sua conta da Adyen, com base em nossa documenta\u00e7\u00e3o sobre a conta da empresa, contas de comerciante e lojas.<\/p>\n<\/li>\n<li>\n<p>Solicite as merchant accounts que voc\u00ea precisa. Forne\u00e7a o m\u00e1ximo de detalhes poss\u00edvel e certifique-se de enviar os documentos e links corretos. Isso tornar\u00e1 o processo de inscri\u00e7\u00e3o mais suave e r\u00e1pido..<\/p>\n<\/li>\n<li>\n<p>Se voc\u00ea precisar de stores em sua estrutura de conta, aguarde a confirma\u00e7\u00e3o de que suas contas de comerciante foram criadas e envie seu formul\u00e1rio de solicita\u00e7\u00e3o de loja.<\/p>\n<\/li>\n<\/ol>\n<p>Voc\u00ea pode adicionar mais merchant accounts e stores posteriormente, mas a estrutura b\u00e1sica deve refletir a estrutura que voc\u00ea planeja ter quando entrar em opera\u00e7\u00e3o.<\/p>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/point-of-sale\/design-your-integration\/determine-account-structure\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Determine a estrutura da conta<\/h6><p>Saiba mais sobre a company account, merchant account e sotres.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/determine-account-structure#step-2-create-merchant-accounts\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Solicitar merchant accounts<\/h6><p>Adicione uma ou mais merchant accounts.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/determine-account-structure#step-3-create-store-ids\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Solicitar stores<\/h6><p>Opcional. Adicione stores \u00e0s suas merchant accounts.<\/p><\/div><\/p><\/a><\/div>\n\n<h2>Etapa 2: defina o escopo da integra\u00e7\u00e3o da API de Terminais.<\/h2>\n<p>A pr\u00f3xima etapa \u00e9 determinar o escopo de sua integra\u00e7\u00e3o.<\/p>\n<div class=\"sc-notice info\"><div>\n<p>Este tamb\u00e9m pode ser um bom momento para aprender sobre nossa <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api\">API de Terminais<\/a> e o <a href=\"\/pt\/account\/payments-lifecycle\">ciclo de vida dos pagamentos<\/a>.<\/p>\n<\/div><\/div>\n<ol>\n<li>\n<p>Escolha sua arquitetura de integra\u00e7\u00e3o:<\/p>\n<ul>\n<li>Com as <strong>comunica\u00e7\u00f5es locais<\/strong>, sua caixa registradora se comunica diretamente com o terminal de pagamento em sua rede local.<\/li>\n<li>\n<p>Com as <strong>comunica\u00e7\u00f5es na nuvem<\/strong>, sua caixa registradora se comunica com o terminal por meio da plataforma de pagamentos da Adyen..<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>D\u00ea uma olhada na <a href=\"\/pt\/point-of-sale\/design-your-integration\/determine-account-structure\/configure-features\">vis\u00e3o geral dos recursos de pagamento<\/a> e siga os links dessa vis\u00e3o geral para entender os recursos aos quais deseja oferecer suporte. Por exemplo, m\u00e9todos de pagamento adicionais, captura atrasada, processamento off-line, dep\u00f3sito e muito mais.<\/p>\n<\/li>\n<li>\n<p>Determine suas necessidades de seguran\u00e7a PCI. Por padr\u00e3o, protegemos as mensagens de pagamento com nossa solu\u00e7\u00e3o de criptografia ponto a ponto (E2EE), mas tamb\u00e9m oferecemos criptografia ponto a ponto (P2PE). Ambos s\u00e3o igualmente seguros. Se voc\u00ea precisar de P2PE, dever\u00e1 nos informar, porque ent\u00e3o precisaremos fornecer um software diferente em seus terminais de pagamento..<\/p>\n<\/li>\n<\/ol>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/point-of-sale\/design-your-integration\/choose-your-architecture\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Arquitetura de integra\u00e7\u00e3o<\/h6><p>Escolha entre uma arquitetura local ou em nuvem.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/determine-account-structure\/configure-features\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Recursos de pagamento<\/h6><p>Escolha rescursos de pagamento al\u00e9m das opera\u00e7\u00f5es b\u00e1sicas.<\/p><\/div><\/p><\/a><a href=\"\/development-resources\/e2ee-p2pe-comparison\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Necessidades de criptografia<\/h6><p>Escolha a criptografia E2EE padr\u00e3o ou criptografia P2PE.<\/p><\/div><\/p><\/a><\/div>\n\n<h2>Etapa 3: fa\u00e7a o pedido de terminais de teste<\/h2>\n<p>Agora vamos nos concentrar nos dispositivos para processamento de pagamentos. Esses dispositivos \u00e0s vezes s\u00e3o chamados de pin entry devices (PED) ou points of interaction (POI), mas os chamamos de terminais.<\/p>\n<ol>\n<li>\n<p>Escolha os terminais que deseja usar. A Adyen possui uma ampla variedade de modelos de terminais para diferentes necessidades de neg\u00f3cios.<\/p>\n<\/li>\n<li>\n<p>Quando voc\u00ea souber quais terminais deseja, \u00e9 hora de solicitar um cart\u00e3o de teste e um ou mais terminais para teste.<\/p>\n<\/li>\n<\/ol>\n<p>Levar\u00e1 pelo menos quatro dias \u00fateis para que seus terminais cheguem..<\/p>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/point-of-sale\/what-we-support\/select-your-terminals\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Selecione os terminais<\/h6><p>Escolha um ou mais modelos de terminais.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/managing-terminals\/order-terminals#sales-order-steps\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Solicite terminais<\/h6><p>Solicite um ou mais terminais de teste e um cart\u00e3o de teste.<\/p><\/div><\/p><\/a><\/div>\n\n<h2>Etapa 4: prepare seus terminais<\/h2>\n<p>Antes de usar seus terminais, voc\u00ea precisa configur\u00e1-los em sua <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">test Customer Area<\/a>. Voc\u00ea pode fazer isso em diferentes n\u00edveis: n\u00edvel de company account, n\u00edvel de merchant account, n\u00edvel de store, e a n\u00edvel de terminal. As configura\u00e7\u00f5es no n\u00edvel company aplicam-se a todos os terminais da empresa. As configura\u00e7\u00f5es no n\u00edvel merchant account ubstituem as configura\u00e7\u00f5es herdadas do n\u00edvel company, e assim por diante.<\/p>\n<ol>\n<li>\n<p>Habilite a API de Terminais.<\/p>\n<\/li>\n<li>\n<p>Adicione m\u00e9todos de pagamento e defina as configura\u00e7\u00f5es do terminal e recursos de pagamento que est\u00e3o no escopo que voc\u00ea decidiu. 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> ir\u00e1 ajud\u00e1-lo com quaisquer recursos que voc\u00ea n\u00e3o consiga configurar totalmente.<\/p>\n<\/li>\n<li>\n<p>Atribua os terminais de teste a uma loja. Isso torna mais f\u00e1cil come\u00e7ar a usar os terminais quando voc\u00ea os recebe. Voc\u00ea pode atribuir terminais de sua \u00e1rea de cliente ou usando nosso Terminal Management API.<\/p>\n<\/li>\n<\/ol>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/point-of-sale\/design-your-integration\/terminal-api#enable-terminal-api\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Ativar API de terminais<\/h6><p>Prepare seus terminais para usar a API da Adyen.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/determine-account-structure\/configure-features\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Configurar recursos<\/h6><p>Adicionar marca e configurar recursos de pagamento.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/managing-terminals\/assign-terminals\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Atribuir terminais<\/h6><p>Prepare seus terminais para uma ativa\u00e7\u00e3o mais r\u00e1pida.<\/p><\/div><\/p><\/a><\/div>\n\n<h2>Etapa 5: configure sua integra\u00e7\u00e3o<\/h2>\n<p>Agora voc\u00ea pode construir sua integra\u00e7\u00e3o.<\/p>\n<ol>\n<li>\n<p>Opcional. Adicione membros da equipe e credenciais de API \u00e0 sua conta. <a id=\"add-users\"><\/a><\/p>\n<ul>\n<li>Voc\u00ea pode criar usu\u00e1rios adicionais da \u00c1rea do Cliente para os membros da sua equipe.<\/li>\n<li>Com sua conta de teste, voc\u00ea tem uma credencial de API padr\u00e3o que usamos para fluxos que exigem autentica\u00e7\u00e3o, como processamento de pagamentos e pedidos de terminais de pagamento.<br \/>\nQuando voc\u00ea entrar no ar, voc\u00ea desejar\u00e1 criar uma credencial de API al\u00e9m da padr\u00e3o ou criar credenciais de API separadas para ponto de venda e com\u00e9rcio eletr\u00f4nico. \u00c9 uma boa pr\u00e1tica (embora n\u00e3o obrigat\u00f3rio) fazer o mesmo em sua conta de teste..<\/li>\n<\/ul>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/account\/users\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Adicionar usu\u00e1rios da \u00e1rea do cliente<\/h6><p>Opcional. D\u00ea aos membros da equipe acesso \u00e0 \u00c1rea do Cliente.<\/p><\/div><\/p><\/a><a href=\"\/development-resources\/api-credentials#new-credential\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Cire credenciais de API<\/h6><p>Opcional. Adicione uma credencial de API a cada merchant account.<\/p><\/div><\/p><\/a><\/div>\n\n<\/li>\n<li>\n<p>Dependendo da arquitetura de integra\u00e7\u00e3o que voc\u00ea escolheu, configure uma <strong>integra\u00e7\u00e3o local<\/strong> ou uma <strong>integra\u00e7\u00e3o em nuvem<\/strong>. Voc\u00ea tamb\u00e9m precisa certificar-se de usar os endere\u00e7os IP ou terminais corretos e a autentica\u00e7\u00e3o adequada. Por exemplo, para uma integra\u00e7\u00e3o em nuvem, voc\u00ea precisa obter uma chave de API.<br \/>\nAo fazer isso, certifique-se de implementar nossas recomenda\u00e7\u00f5es de rede.<\/p>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/point-of-sale\/design-your-integration\/choose-your-architecture\/local\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Integra\u00e7\u00e3o Local?<\/h6><p>Configure sua rede e proteja suas solicita\u00e7\u00f5es.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/choose-your-architecture\/cloud\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Integra\u00e7\u00e3o em nuvem?<\/h6><p>Configure sua rede para comunica\u00e7\u00e3o em nuvem.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/terminal-api#endpoints\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Autentica\u00e7\u00e3o<\/h6><p>Aprenda sobre endere\u00e7os IP, terminais e autentica\u00e7\u00e3o.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/design-your-integration\/network-and-connectivity\/network-configuration\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Recomenda\u00e7\u00f5es de rede<\/h6><p>Dicas para configura\u00e7\u00e3o e conectividade de rede.<\/p><\/div><\/p><\/a><\/div>\n\n<\/li>\n<li>\n<p>Ao receber os terminais de teste, siga as etapas no manual do modelo do terminal para coloc\u00e1-los em funcionamento. As etapas s\u00e3o:<\/p>\n<ul>\n<li>Inspecione o terminal para verificar se ele n\u00e3o foi adulterado.<\/li>\n<li>Insira o rolo de papel de recibo.<\/li>\n<li>Ligue o terminal.<\/li>\n<li>Conecte o terminal \u00e0 sua rede.<\/li>\n<li>Embarque no terminal.<\/li>\n<li>este a conex\u00e3o com a plataforma de pagamentos da Adyen.<\/li>\n<\/ul>\n<div class=\"next-steps\" id=\"next-steps\" style=display:block;>\n<a href=\"\/point-of-sale\/user-manuals\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Prepare os terminais<\/h6><p>Conecte e ative os terminais ao receb\u00ea-los.<\/p><\/div><\/p><\/a><\/div>\n\n<\/li>\n<\/ol>\n<h2>Etapa 6: teste sua integra\u00e7\u00e3o<\/h2>\n<p>Agora \u00e9 hora de testar exaustivamente todos os aspectos de sua integra\u00e7\u00e3o, desde fazer um pagamento at\u00e9 a reconcilia\u00e7\u00e3o.<\/p>\n<ol>\n<li>\n<p>Fa\u00e7a v\u00e1rios tipos de transa\u00e7\u00f5es de teste<\/p>\n<ul>\n<li>\n<p>Fa\u00e7a pagamentos:<\/p>\n<ul>\n<li><a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/make-a-payment\">Teste o fluxo feliz<\/a> azendo pagamentos com seus terminais de teste e cart\u00e3o de teste.<\/li>\n<li><a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/verify-transaction-status\">Teste fluxos insatisfat\u00f3rios<\/a>, como tempos limite e problemas de conex\u00e3o.<\/li>\n<li><a href=\"\/pt\/point-of-sale\/testing-pos-payments\">Simule v\u00e1rias respostas do adquirente<\/a> para testar seu tratamento de transa\u00e7\u00f5es recusadas.<\/li>\n<li>\n<p><a href=\"\/pt\/point-of-sale\/testing-pos-payments\">Teste diferentes tipos de cart\u00e3o e m\u00e9todos de verifica\u00e7\u00e3o do titular do cart\u00e3o (CVM)<\/a>.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/cancel-a-transaction\">Cancele pagamentos<\/a>, tanto da caixa registradora quanto do terminal.<\/p>\n<\/li>\n<li>\n<p><a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/refund-payment\">Refund payments<\/a>, com ou sem refer\u00eancia a uma transa\u00e7\u00e3o original.<\/p>\n<\/li>\n<li>\n<p>Teste os m\u00e9todos de pagamento e os recursos que voc\u00ea adicionou \u00e0 sua integra\u00e7\u00e3o.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Aprenda como lidar com pagamentos falhados e outras condi\u00e7\u00f5es de erro e como resolver problemas com seus terminais.<\/p>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/point-of-sale\/error-scenarios\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Lide com erros<\/h6><p>Saiba mais sobre condi\u00e7\u00f5es de erro e quando tentar pagamentos com falha novamente.<\/p><\/div><\/p><\/a><a href=\"\/point-of-sale\/pos-troubleshooting\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Solu\u00e7\u00f5es de problemas para terminais<\/h6><p>Aprenda a resolver problemas com seus terminais<\/p><\/div><\/p><\/a><\/div>\n\n<\/li>\n<li>\n<p>Certifique-se de que sua reconcilia\u00e7\u00e3o esteja funcionando.<\/p>\n<ul>\n<li>Baixe o relat\u00f3rio de detalhes do acordo automaticamente.<\/li>\n<li>Aprenda como automatizar sua reconcilia\u00e7\u00e3o de pagamento.<\/li>\n<li>Se voc\u00ea estiver usando IDs de loja ou convers\u00e3o de moeda (DCC), pe\u00e7a \u00e0 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> para adicionar esses campos aos seus relat\u00f3rios.<\/li>\n<\/ul>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/reporting\/settlement-detail-report\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Detalhes de liquida\u00e7\u00e3o<\/h6><p>Baixe este relat\u00f3rio automaticamente.<\/p><\/div><\/p><\/a><a href=\"\/reporting\/settlement-reconciliation\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Automatizar reconcilia\u00e7\u00e3o<\/h6><p>Aprenda como automatizar sua reconcilia\u00e7\u00e3o de pagamento.<\/p><\/div><\/p><\/a><\/div>\n\n<\/li>\n<\/ol>\n<h2>Ao vivo<\/h2>\n<p>Ao terminar o teste, primeiro voc\u00ea deve se inscrever para uma conta ativa e assinar o contrato antes de colocar sua integra\u00e7\u00e3o ao vivo.<\/p>\n<div class=\"next-steps\" id=\"next-steps\" style=display:block;>\n<a href=\"\/get-started-with-adyen#apply-for-your-live-account\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Go live com a Adyen<\/h6><p>Escreva-se para uma conta e assine o contrato.<\/p><\/div><\/p><\/a><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/get-started\/tapi-checklist","articleFields":{"description":"Checklist para construir uma integra\u00e7\u00e3o determinais com a API da Adyen.","last_edit_on":"18-11-2020 19:19"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/get-started\/tapi-checklist","title":"Construa sua integra\u00e7\u00e3o com a API de Terminais","content":"\nSupportArtigos, FAQs e solicita\u00e7\u00e3o de suporte: Adyen Help\n\nUma integra\u00e7\u00e3o com API de terminais da Adyen permite que voc\u00ea inicie os pagamentos de seu sistema de caixa registradora e processe esses pagamentos por meio da Adyen usando nossos terminais de pagamento.\nAqui, descrevemos como voc\u00ea pode construir tal integra\u00e7\u00e3o em um ambiente de teste antes de ir ao ar.\nAntes de voc\u00ea come\u00e7ar\n\nLeia a vis\u00e3o geral dos Primeiros passos com a Adyen e inscreva-se para uma conta de teste.\n\nEtapa 1: configure sua conta de teste da Adyen\nDepois de se inscrever para uma conta de teste da Adyen, voc\u00ea tem acesso \u00e0 sua test Customer Area. Neste ambiente de teste, voc\u00ea precisa configurar uma estrutura para sua conta da Adyen. A estrutura mais adequada para voc\u00ea atende \u00e0s suas necessidades de neg\u00f3cios.\n\n\nDetermine a estrutura de sua conta da Adyen, com base em nossa documenta\u00e7\u00e3o sobre a conta da empresa, contas de comerciante e lojas.\n\n\nSolicite as merchant accounts que voc\u00ea precisa. Forne\u00e7a o m\u00e1ximo de detalhes poss\u00edvel e certifique-se de enviar os documentos e links corretos. Isso tornar\u00e1 o processo de inscri\u00e7\u00e3o mais suave e r\u00e1pido..\n\n\nSe voc\u00ea precisar de stores em sua estrutura de conta, aguarde a confirma\u00e7\u00e3o de que suas contas de comerciante foram criadas e envie seu formul\u00e1rio de solicita\u00e7\u00e3o de loja.\n\n\nVoc\u00ea pode adicionar mais merchant accounts e stores posteriormente, mas a estrutura b\u00e1sica deve refletir a estrutura que voc\u00ea planeja ter quando entrar em opera\u00e7\u00e3o.\n\nDetermine a estrutura da contaSaiba mais sobre a company account, merchant account e sotres.Solicitar merchant accountsAdicione uma ou mais merchant accounts.Solicitar storesOpcional. Adicione stores \u00e0s suas merchant accounts.\n\nEtapa 2: defina o escopo da integra\u00e7\u00e3o da API de Terminais.\nA pr\u00f3xima etapa \u00e9 determinar o escopo de sua integra\u00e7\u00e3o.\n\nEste tamb\u00e9m pode ser um bom momento para aprender sobre nossa API de Terminais e o ciclo de vida dos pagamentos.\n\n\n\nEscolha sua arquitetura de integra\u00e7\u00e3o:\n\nCom as comunica\u00e7\u00f5es locais, sua caixa registradora se comunica diretamente com o terminal de pagamento em sua rede local.\n\nCom as comunica\u00e7\u00f5es na nuvem, sua caixa registradora se comunica com o terminal por meio da plataforma de pagamentos da Adyen..\n\n\n\n\n\nD\u00ea uma olhada na vis\u00e3o geral dos recursos de pagamento e siga os links dessa vis\u00e3o geral para entender os recursos aos quais deseja oferecer suporte. Por exemplo, m\u00e9todos de pagamento adicionais, captura atrasada, processamento off-line, dep\u00f3sito e muito mais.\n\n\nDetermine suas necessidades de seguran\u00e7a PCI. Por padr\u00e3o, protegemos as mensagens de pagamento com nossa solu\u00e7\u00e3o de criptografia ponto a ponto (E2EE), mas tamb\u00e9m oferecemos criptografia ponto a ponto (P2PE). Ambos s\u00e3o igualmente seguros. Se voc\u00ea precisar de P2PE, dever\u00e1 nos informar, porque ent\u00e3o precisaremos fornecer um software diferente em seus terminais de pagamento..\n\n\n\nArquitetura de integra\u00e7\u00e3oEscolha entre uma arquitetura local ou em nuvem.Recursos de pagamentoEscolha rescursos de pagamento al\u00e9m das opera\u00e7\u00f5es b\u00e1sicas.Necessidades de criptografiaEscolha a criptografia E2EE padr\u00e3o ou criptografia P2PE.\n\nEtapa 3: fa\u00e7a o pedido de terminais de teste\nAgora vamos nos concentrar nos dispositivos para processamento de pagamentos. Esses dispositivos \u00e0s vezes s\u00e3o chamados de pin entry devices (PED) ou points of interaction (POI), mas os chamamos de terminais.\n\n\nEscolha os terminais que deseja usar. A Adyen possui uma ampla variedade de modelos de terminais para diferentes necessidades de neg\u00f3cios.\n\n\nQuando voc\u00ea souber quais terminais deseja, \u00e9 hora de solicitar um cart\u00e3o de teste e um ou mais terminais para teste.\n\n\nLevar\u00e1 pelo menos quatro dias \u00fateis para que seus terminais cheguem..\n\nSelecione os terminaisEscolha um ou mais modelos de terminais.Solicite terminaisSolicite um ou mais terminais de teste e um cart\u00e3o de teste.\n\nEtapa 4: prepare seus terminais\nAntes de usar seus terminais, voc\u00ea precisa configur\u00e1-los em sua test Customer Area. Voc\u00ea pode fazer isso em diferentes n\u00edveis: n\u00edvel de company account, n\u00edvel de merchant account, n\u00edvel de store, e a n\u00edvel de terminal. As configura\u00e7\u00f5es no n\u00edvel company aplicam-se a todos os terminais da empresa. As configura\u00e7\u00f5es no n\u00edvel merchant account ubstituem as configura\u00e7\u00f5es herdadas do n\u00edvel company, e assim por diante.\n\n\nHabilite a API de Terminais.\n\n\nAdicione m\u00e9todos de pagamento e defina as configura\u00e7\u00f5es do terminal e recursos de pagamento que est\u00e3o no escopo que voc\u00ea decidiu. Nossa Support Team ir\u00e1 ajud\u00e1-lo com quaisquer recursos que voc\u00ea n\u00e3o consiga configurar totalmente.\n\n\nAtribua os terminais de teste a uma loja. Isso torna mais f\u00e1cil come\u00e7ar a usar os terminais quando voc\u00ea os recebe. Voc\u00ea pode atribuir terminais de sua \u00e1rea de cliente ou usando nosso Terminal Management API.\n\n\n\nAtivar API de terminaisPrepare seus terminais para usar a API da Adyen.Configurar recursosAdicionar marca e configurar recursos de pagamento.Atribuir terminaisPrepare seus terminais para uma ativa\u00e7\u00e3o mais r\u00e1pida.\n\nEtapa 5: configure sua integra\u00e7\u00e3o\nAgora voc\u00ea pode construir sua integra\u00e7\u00e3o.\n\n\nOpcional. Adicione membros da equipe e credenciais de API \u00e0 sua conta. \n\nVoc\u00ea pode criar usu\u00e1rios adicionais da \u00c1rea do Cliente para os membros da sua equipe.\nCom sua conta de teste, voc\u00ea tem uma credencial de API padr\u00e3o que usamos para fluxos que exigem autentica\u00e7\u00e3o, como processamento de pagamentos e pedidos de terminais de pagamento.\nQuando voc\u00ea entrar no ar, voc\u00ea desejar\u00e1 criar uma credencial de API al\u00e9m da padr\u00e3o ou criar credenciais de API separadas para ponto de venda e com\u00e9rcio eletr\u00f4nico. \u00c9 uma boa pr\u00e1tica (embora n\u00e3o obrigat\u00f3rio) fazer o mesmo em sua conta de teste..\n\n\nAdicionar usu\u00e1rios da \u00e1rea do clienteOpcional. D\u00ea aos membros da equipe acesso \u00e0 \u00c1rea do Cliente.Cire credenciais de APIOpcional. Adicione uma credencial de API a cada merchant account.\n\n\n\nDependendo da arquitetura de integra\u00e7\u00e3o que voc\u00ea escolheu, configure uma integra\u00e7\u00e3o local ou uma integra\u00e7\u00e3o em nuvem. Voc\u00ea tamb\u00e9m precisa certificar-se de usar os endere\u00e7os IP ou terminais corretos e a autentica\u00e7\u00e3o adequada. Por exemplo, para uma integra\u00e7\u00e3o em nuvem, voc\u00ea precisa obter uma chave de API.\nAo fazer isso, certifique-se de implementar nossas recomenda\u00e7\u00f5es de rede.\n\nIntegra\u00e7\u00e3o Local?Configure sua rede e proteja suas solicita\u00e7\u00f5es.Integra\u00e7\u00e3o em nuvem?Configure sua rede para comunica\u00e7\u00e3o em nuvem.Autentica\u00e7\u00e3oAprenda sobre endere\u00e7os IP, terminais e autentica\u00e7\u00e3o.Recomenda\u00e7\u00f5es de redeDicas para configura\u00e7\u00e3o e conectividade de rede.\n\n\n\nAo receber os terminais de teste, siga as etapas no manual do modelo do terminal para coloc\u00e1-los em funcionamento. As etapas s\u00e3o:\n\nInspecione o terminal para verificar se ele n\u00e3o foi adulterado.\nInsira o rolo de papel de recibo.\nLigue o terminal.\nConecte o terminal \u00e0 sua rede.\nEmbarque no terminal.\neste a conex\u00e3o com a plataforma de pagamentos da Adyen.\n\n\nPrepare os terminaisConecte e ative os terminais ao receb\u00ea-los.\n\n\n\nEtapa 6: teste sua integra\u00e7\u00e3o\nAgora \u00e9 hora de testar exaustivamente todos os aspectos de sua integra\u00e7\u00e3o, desde fazer um pagamento at\u00e9 a reconcilia\u00e7\u00e3o.\n\n\nFa\u00e7a v\u00e1rios tipos de transa\u00e7\u00f5es de teste\n\n\nFa\u00e7a pagamentos:\n\nTeste o fluxo feliz azendo pagamentos com seus terminais de teste e cart\u00e3o de teste.\nTeste fluxos insatisfat\u00f3rios, como tempos limite e problemas de conex\u00e3o.\nSimule v\u00e1rias respostas do adquirente para testar seu tratamento de transa\u00e7\u00f5es recusadas.\n\nTeste diferentes tipos de cart\u00e3o e m\u00e9todos de verifica\u00e7\u00e3o do titular do cart\u00e3o (CVM).\n\n\n\n\n\nCancele pagamentos, tanto da caixa registradora quanto do terminal.\n\n\nRefund payments, com ou sem refer\u00eancia a uma transa\u00e7\u00e3o original.\n\n\nTeste os m\u00e9todos de pagamento e os recursos que voc\u00ea adicionou \u00e0 sua integra\u00e7\u00e3o.\n\n\n\n\n\nAprenda como lidar com pagamentos falhados e outras condi\u00e7\u00f5es de erro e como resolver problemas com seus terminais.\n\nLide com errosSaiba mais sobre condi\u00e7\u00f5es de erro e quando tentar pagamentos com falha novamente.Solu\u00e7\u00f5es de problemas para terminaisAprenda a resolver problemas com seus terminais\n\n\n\nCertifique-se de que sua reconcilia\u00e7\u00e3o esteja funcionando.\n\nBaixe o relat\u00f3rio de detalhes do acordo automaticamente.\nAprenda como automatizar sua reconcilia\u00e7\u00e3o de pagamento.\nSe voc\u00ea estiver usando IDs de loja ou convers\u00e3o de moeda (DCC), pe\u00e7a \u00e0 nossa Support Team para adicionar esses campos aos seus relat\u00f3rios.\n\n\nDetalhes de liquida\u00e7\u00e3oBaixe este relat\u00f3rio automaticamente.Automatizar reconcilia\u00e7\u00e3oAprenda como automatizar sua reconcilia\u00e7\u00e3o de pagamento.\n\n\n\nAo vivo\nAo terminar o teste, primeiro voc\u00ea deve se inscrever para uma conta ativa e assinar o contrato antes de colocar sua integra\u00e7\u00e3o ao vivo.\n\nGo live com a AdyenEscreva-se para uma conta e assine o contrato.\n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Iniciando","lvl3":"Construa sua integra\u00e7\u00e3o com a API de Terminais"},"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\/get-started","lvl3":"\/pt\/point-of-sale\/get-started\/tapi-checklist"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Construa","integra\u00e7\u00e3o","Terminais"]}}