No momento, o ajuste de autoriza\u00e7\u00e3o est\u00e1 dispon\u00edvel para Discover, Mastercard e Visa. Em \u00faltima an\u00e1lise, o suporte depende do emissor.<\/p>\n<\/div><\/div>\n
Casos de uso<\/h3>\n
Existem v\u00e1rios casos de uso para ajustar uma quantidade pr\u00e9-autorizada:<\/p>\n
- \n
- \n
Hospitalidade. Por exemplo, em um hotel<\/p>\n
- \n
- No momento do check-in, o hotel pr\u00e9-autoriza o pagamento do quarto que o h\u00f3spede reservou. Ao mesmo tempo, o hotel cria um token de reconhecimento do comprador<\/a>, para poder aplicar cobran\u00e7as em atraso quando necess\u00e1rio.<\/li>\n
- Durante a estadia, o h\u00f3spede incorre em despesas nas instala\u00e7\u00f5es do hotel. O hotel adiciona essas despesas ao valor pr\u00e9-autorizado, ajustando a autoriza\u00e7\u00e3o.<\/li>\n
- No momento do check-out, o hotel captura o valor final ou cancela o pagamento se o h\u00f3spede preferir pagar a conta com uma forma de pagamento diferente.<\/li>\n
- Se necess\u00e1rio, o hotel cobra do h\u00f3spede ap\u00f3s a partida, usando o token de reconhecimento do comprador para um novo pagamento.<\/li>\n<\/ol>\n<\/li>\n
- \n
Gorjeta<\/a> em regi\u00f5es e ind\u00fastrias em que \u00e9 habitual que o h\u00f3spede adicione uma dica no recibo ap\u00f3s a apresenta\u00e7\u00e3o do cart\u00e3o.<\/p>\n<\/li>\n<\/ul>\n
Ajuste ass\u00edncrono ou s\u00edncrono<\/h2>\n
Existem duas maneiras de implementar a pr\u00e9-autoriza\u00e7\u00e3o:<\/p>\n
- \n
- \n
Com o ajuste de autoriza\u00e7\u00e3o ass\u00edncrona<\/strong>, voc\u00ea se refere a um pagamento usando a refer\u00eancia PSP que voc\u00ea recebeu na resposta \u00e0 sua solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o. Em cada solicita\u00e7\u00e3o de ajuste de autoriza\u00e7\u00e3o e na solicita\u00e7\u00e3o de captura final, voc\u00ea s\u00f3 precisa especificar esta primeira refer\u00eancia PSP.<\/p>\n
O ajuste ass\u00edncrono \u00e9 mais f\u00e1cil de implementar, mas n\u00e3o fica claro imediatamente se o ajuste foi bem-sucedido. Voc\u00ea precisa configurar as notifica\u00e7\u00f5es do webhook para receber atualiza\u00e7\u00f5es e saber se o valor final foi autorizado antes de capturar o pagamento.<\/p>\n<\/li>\n
- \n
Com o ajuste de autoriza\u00e7\u00e3o s\u00edncrona<\/strong>, voc\u00ea passa um blob
adjustAuthorisationData<\/code> de um ajuste de autoriza\u00e7\u00e3o para o pr\u00f3ximo, para nos permitir acompanhar o valor mais recente. Voc\u00ea recebe o primeiro blob na resposta \u00e0 sua solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o. Na sua primeira solicita\u00e7\u00e3o de ajuste de autoriza\u00e7\u00e3o, voc\u00ea especifica o blob recebido para a pr\u00e9-autoriza\u00e7\u00e3o e recebe um novo blob na resposta. No seu pr\u00f3ximo ajuste, voc\u00ea especifica o blob que voc\u00ea recebeu na resposta do ajuste anterior e assim por diante.<\/p>\nO ajuste s\u00edncrono requer uma etapa adicional para implementar, porque voc\u00ea precisa acompanhar o blob mais recente. A vantagem \u00e9 que voc\u00ea recebe o resultado do ajuste de forma s\u00edncrona. Dessa forma, voc\u00ea saber\u00e1 imediatamente se o valor final foi autorizado antes de capturar o pagamento.<\/p>\n
\nSe, em algum momento, voc\u00ea n\u00e3o conseguir passar no blob, o fluxo retornar\u00e1 ao ajuste ass\u00edncrono e n\u00e3o ser\u00e1 mais poss\u00edvel retornar ao ajuste s\u00edncrono para esse pagamento.<\/p>\n<\/div><\/div>\n<\/li>\n<\/ul>\n
Antes de voc\u00ea come\u00e7ar<\/h2>\n
Antes de configurar e usar a pr\u00e9-autoriza\u00e7\u00e3o, certifique-se de:<\/p>\n
- \n
- Ler e entender nossos fundamentos da API de terminais<\/a>.<\/li>\n
- Criar uma integra\u00e7\u00e3o capaz de efetuar um pagamento<\/a>.<\/li>\n
- Configurar as notifica\u00e7\u00f5es de webhook<\/a>. Voc\u00ea precisar\u00e1 confiar nas notifica\u00e7\u00f5es para saber se a captura foi bem-sucedida. Se voc\u00ea usar o ajuste de autoriza\u00e7\u00e3o ass\u00edncrono, tamb\u00e9m precisar\u00e1 confiar em notifica\u00e7\u00f5es para o resultado do ajuste de autoriza\u00e7\u00e3o.<\/li>\n<\/ul>\n
Lembre-se tamb\u00e9m de que voc\u00ea precisa implementar a l\u00f3gica do seu lado, por exemplo, para decidir quando usar o fluxo de pr\u00e9-autoriza\u00e7\u00e3o e calcular a quantia ao fazer um ajuste de autoriza\u00e7\u00e3o.<\/p>\n
Etapa 1 (opcional): configure sua conta<\/h2>\n
H\u00e1 dois aspectos da sua conta que voc\u00ea pode querer configurar para pr\u00e9-autoriza\u00e7\u00e3o:<\/p>\n
- \n
- \n
Ajuste de autoriza\u00e7\u00e3o s\u00edncrona<\/strong>: para receber os resultados do ajuste de autoriza\u00e7\u00e3o de forma s\u00edncrona, pe\u00e7a \u00e0 nossa Support Team<\/a> para ativar isso.<\/p>\n<\/li>\n
- \n
Tipo de autoriza\u00e7\u00e3o padr\u00e3o<\/strong>: geralmente o tipo de autoriza\u00e7\u00e3o padr\u00e3o \u00e9 Final<\/strong>, o que significa que o pagamento \u00e9 capturado automaticamente quando autorizado. Como esse \u00e9 o padr\u00e3o, voc\u00ea n\u00e3o precisa especific\u00e1-lo em seus pedidos de pagamento. No entanto, com a pr\u00e9-autoriza\u00e7\u00e3o, voc\u00ea precisa especificar um tipo de autoriza\u00e7\u00e3o de PreAuth<\/strong> na sua solicita\u00e7\u00e3o de pagamento. Se voc\u00ea fizer apenas solicita\u00e7\u00f5es de pagamento com pr\u00e9-autoriza\u00e7\u00e3o, poder\u00e1 solicitar \u00e0 nossa Support Team<\/a> que defina seu tipo de autoriza\u00e7\u00e3o padr\u00e3o como PreAuth<\/strong> para que voc\u00ea n\u00e3o precise especific\u00e1-lo nas solicita\u00e7\u00f5es de pagamento.<\/p>\n
\nSe voc\u00ea deseja fazer solicita\u00e7\u00f5es de pagamento com pr\u00e9-autoriza\u00e7\u00e3o e solicita\u00e7\u00f5es de pagamento normais, recomendamos que voc\u00ea especifique o tipo de autoriza\u00e7\u00e3o em todas as solicita\u00e7\u00f5es de pagamento.<\/p>\n<\/div><\/div>\n<\/li>\n<\/ul>\n
Etapa 2: pr\u00e9-autorizar um pagamento<\/h2>\n
Para iniciar o fluxo de pagamento de pr\u00e9-autoriza\u00e7\u00e3o, fa\u00e7a um
PaymentRequest<\/code> com um tipo de autoriza\u00e7\u00e3o de PreAuth<\/strong>:<\/p>\n- \n
- \n
Fa\u00e7a uma solicita\u00e7\u00e3o POST para um endpoint da API de terminais<\/a>, especificando:<\/p>\n
- \n
- \n
MessageHeader<\/code>: Segue a estruturaMessageHeader<\/code> padr\u00e3o, explicada nos fundamentos da API de terminais<\/a>, que incluem:<\/p>\n- \n
ProtocolVersion<\/code>: 3.0<\/strong><\/li>\nMessageClass<\/code>: Service<\/strong><\/li>\nMessageCategory<\/code>: Payment<\/strong>.<\/li>\nMessageType<\/code>: Request<\/strong><\/li>\nSaleID<\/code>: Seu ID exclusivo para a caixa registradora.<\/li>\nServiceID<\/code>: Seu ID exclusivo para esta tentativa de transa\u00e7\u00e3o, consistindo em 1 a 10 caracteres alfanum\u00e9ricos. Esse valor precisa ser exclusivo nas \u00faltimas 48 horas.<\/li>\nPOIID<\/code>: : ID exclusivo do terminal. Isso indica para qual terminal o pagamento ser\u00e1 roteado.<\/li>\n<\/ul>\n\n<\/li>\n- \n
PaymentRequest<\/code>: O corpo da solicita\u00e7\u00e3o da solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o deve incluir:<\/p>\n- \n
SaleData.SaleTransactionID.TransactionID<\/code>: Sua refer\u00eancia exclusiva para esta solicita\u00e7\u00e3o de pagamento.<\/li>\nSaleData.SaleTransactionID.TimeStamp<\/code>: Data e hora da solicita\u00e7\u00e3o de pagamento, no formato UTC<\/a>.<\/li>\nSaleData.SaleToAcquirerData<\/code>:\n- \n
- authorisationType=PreAuth<\/strong>: indica que esta \u00e9 uma solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o.<\/li>\n
- Quaisquer outros pares de valores-chave que voc\u00ea deseja passar, por exemplo, para fins de reconhecimento de clientes<\/a> purposes.<\/li>\n<\/ul><\/li>\n
PaymentTransaction.AmountsReq.Currency<\/code>: A moeda<\/a> da transa\u00e7\u00e3o.<\/li>\n- \n
PaymentTransaction.AmountsReq.RequestedAmount<\/code>: O valor da transa\u00e7\u00e3o.<\/p>\n\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\nO exemplo a seguir mostra como voc\u00ea iniciaria a pr\u00e9-autoriza\u00e7\u00e3o para um pagamento de EUR 150,00<\/strong>.<\/p>\n
\nPara obter mais informa\u00e7\u00f5es sobre a estrutura de solicita\u00e7\u00e3o da API de terminais, consulte os fundamentos da API de terminais<\/a>.<\/p>\n<\/div>\n
\n<\/code-sample>\n<\/div>\n O cliente apresenta seu cart\u00e3o no terminal de pagamento. O terminal coleta os detalhes do pagamento e envia a solicita\u00e7\u00e3o do valor original \u00e0 plataforma de pagamentos da Adyen para processamento<\/p>\n
Se a pr\u00e9-autoriza\u00e7\u00e3o for bem sucedida:<\/p>\n
- \n
- Approved<\/strong> \u00e9 exibido no visor do terminal.<\/li>\n
- \n
O resultado do pagamento cont\u00e9m:<\/p>\n
- \n
- \n
POIData.POITransactionID.TransactionID<\/code>: Identificador de transa\u00e7\u00e3o<\/a> para o pagamento, no formato Tender_reference.PSP_reference<\/strong>.<\/p>\n<\/li>\n- \n
PaymentResult<\/code>: Payment method data including:<\/p>\n- \n
- \n
AmountsResp<\/code>: OAuthorizedAmount<\/code> eCurrency<\/code> do pagamento pr\u00e9-autorizado.<\/p>\n\n<\/li>\n<\/ul>\n<\/li>\n- \n
Response.Result<\/code>: Success<\/strong><\/p>\n<\/li>\n- \n
Response.AdditionalResponse<\/code>: Uma sequ\u00eancia base64. Quando decodificado, este \u00e9 um objeto JSON com dados de transa\u00e7\u00e3o adicionais. Isso inclui:<\/p>\n- \n
posadditionalamounts.originalAmountValue<\/code>: OMontante original em unidades menores.<\/li>\nauthorisedAmountValue<\/code>: Quantidade autorizada em unidades menores, que nesta fase \u00e9 igual \u00e0 quantidade original.<\/li>\npspReference<\/code>: A refer\u00eancia PSP da sua solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o.<\/li>\nadjustAuthorisationData<\/code>: Um blob codificado em URL.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\nO exemplo a seguir mostra a resposta a uma solicita\u00e7\u00e3o de autoriza\u00e7\u00e3o de EUR 150,00.<\/p>\n
\n<\/code-sample>\n<\/div>\n<\/li>\n - \n
Armazene o arquivo
pspReference<\/code> daAdditionalResponse<\/code> para uso posterior ao ajustar a autoriza\u00e7\u00e3o ou ao capturar o pagamento.<\/p>\n<\/li>\n- \n
Se voc\u00ea estiver usando o ajuste de autoriza\u00e7\u00e3o s\u00edncrona, decodifique o URL blob
adjustAuthorisationData<\/code> e o armazene.<\/p>\n<\/li>\n<\/ol>\nEtapa 3 (opcional): ajuste a pr\u00e9-autoriza\u00e7\u00e3o<\/h2>\n
Para modificar o valor pr\u00e9-autorizado, fa\u00e7a uma solicita\u00e7\u00e3o de ajuste de autoriza\u00e7\u00e3o.<\/p>\n\n
\n\nEtapa 4: finalize o pagamento pr\u00e9-autorizado<\/h2>\n
Quando voc\u00ea fiezer seu \u00faltimo ajuste de autoriza\u00e7\u00e3o, precisar\u00e1 capturar manualmente o pagamento<\/a> para garantir que os fundos reservados sejam transferidos para sua conta:<\/p>\n
\nSempre verifique se voc\u00ea concluiu todos os ajustes de autoriza\u00e7\u00e3o para o pagamento antes de captur\u00e1-lo. As capturas s\u00e3o feitas de forma ass\u00edncrona, portanto, pode parecer que o pagamento ainda n\u00e3o foi capturado e ainda \u00e9 poss\u00edvel ajustar a autoriza\u00e7\u00e3o<\/p>\n<\/div><\/div>\n
- \n
- \n
- \n
- Decida se voc\u00ea est\u00e1 pronto para capturar o pagamento:<\/li>\n<\/ol>\n
- \n
- \n
Existem cobran\u00e7as adicionais a serem feitas?
\nSe sim, ajuste a autoriza\u00e7\u00e3o primeiro (consulte a Etapa 3<\/a>).<\/p>\n\n<\/li>\n- \n
O cliente deseja liquidar a fatura usando um m\u00e9todo de pagamento diferente daquele usado para a pr\u00e9-autoriza\u00e7\u00e3o?
\nSe sim, n\u00e3o capture o pagamento. Em vez disso, cancele a pr\u00e9-autoriza\u00e7\u00e3o:<\/p>\n- \n
- \n
Fa\u00e7a uma solicita\u00e7\u00e3o \/payments\/{paymentPspReference}\/cancels<\/a> especificando a
pspReference<\/code> da pr\u00e9-autoriza\u00e7\u00e3o original. Consulte Cancelar autoriza\u00e7\u00e3o<\/a> para obter mais detalhes.<\/p>\n\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n- \n
Quando voc\u00ea estiver pronto para capturar o pagamento, fa\u00e7a uma solicita\u00e7\u00e3o POST para o endpoint do \/payments\/{paymentPspReference}\/captures<\/a> ,\u00a0especificando:<\/p>\n
- \n
paymentPspReference<\/code>: ApspReference<\/code> da pr\u00e9-autoriza\u00e7\u00e3o original. Voc\u00ea recebeu isso na resposta \u00e0 sua solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o<\/li>\namount<\/code>: Acurrency<\/code> evalue<\/code> do valor final em minor units<\/strong>. Essa \u00e9 a soma do valor original pr\u00e9-autorizado e de todos os ajustes posteriores.<\/li>\nreference<\/code>: Sua refer\u00eancia a esta modifica\u00e7\u00e3o de pagamento para uso em seu processo de reconcilia\u00e7\u00e3o.<\/li>\nmerchantAccount<\/code>: O nome da sua conta de comerciante usada para processar o pagamento.<\/li>\n<\/ul>\n\n<\/code-sample>\n<\/div>\n<\/li>\n - \n
Ao receber a resposta da captura, observe o seguinte:<\/p>\n
- \n
pspReference<\/code>: A refer\u00eancia PSP associada a esta solicita\u00e7\u00e3o\u00a0de captura. Observe que esta \u00e9 diferente da refer\u00eancia PSP associada \u00e0 solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o.<\/li>\nstatus<\/code>: received<\/strong>.<\/li>\nreference<\/code>: Sua refer\u00eancia a esta modifica\u00e7\u00e3o de pagamento para uso em seu processo de reconcilia\u00e7\u00e3o.<\/li>\n<\/ul>\n\n<\/code-sample>\n<\/div>\n<\/li>\n - \n
- \n
- Aguarde a notifica\u00e7\u00e3o ass\u00edncrona<\/a>. Isso informa se o valor final foi capturado.
\nSe a captura for bem sucedida, esta notifica\u00e7\u00e3o conter\u00e1:\n- \n
eventCode<\/code>: CAPTURE<\/strong><\/li>\noriginalReference<\/code>: OpspReference<\/code> da pr\u00e9-autoriza\u00e7\u00e3o.<\/li>\npspReference<\/code>: A refer\u00eancia do PSP associada a esta solicita\u00e7\u00e3o\u00a0de captura.<\/li>\nsuccess<\/code>: true<\/strong><\/li>\n<\/ul><\/li>\n<\/ol>\n\nSe
success<\/code> for false<\/strong>, ent\u00e3o sua solicita\u00e7\u00e3o de captura falhou. Revise oreason<\/code> que voc\u00ea recebeu na notifica\u00e7\u00e3o, corrija o problema e envie a solicita\u00e7\u00e3o de captura novamente.<\/p>\n<\/div><\/div>\n<\/li>\n<\/ol>\n\nSe voc\u00ea precisar cobrar do h\u00f3spede uma quantia adicional ap\u00f3s a partida e tiver criado um token de reconhecimento de cliente com sua solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o, poder\u00e1 aplicar essas cobran\u00e7as em atraso em uma solicita\u00e7\u00e3o de pagamento normal usando o token. Consulte Reconhecimento do cliente<\/a>.<\/p>\n<\/div><\/div>\n
Veja tamb\u00e9m<\/h2>\n
\n- \n Captura manual\n <\/a><\/li>
- \n Ajustar autoriza\u00e7\u00e3o\n <\/a><\/li>
- \n Reconhecimento do cliente\n <\/a><\/li>
- \n Notifica\u00e7\u00e3o Webhook\n <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/pre-authorisation","articleFields":{"description":"Pr\u00e9-autorize um pagamento, ajuste o valor autorizado e capture o pagamento.","last_edit_on":"07-05-2020 17:34"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/pre-authorisation","title":"Pr\u00e9-autoriza\u00e7\u00e3o","content":"Em um fluxo de pagamento b\u00e1sico, o valor a pagar da sua solicita\u00e7\u00e3o de pagamento \u00e9 autorizado e capturado. Mas, \u00e0s vezes, voc\u00ea pode alterar o valor ou estender a dura\u00e7\u00e3o da autoriza\u00e7\u00e3o antes que o pagamento seja capturado. Voc\u00ea pode fazer isso usando pr\u00e9-autoriza\u00e7\u00e3o. Nesse fluxo de pagamento, voc\u00ea pode aumentar ou diminuir o valor autorizado posteriormente e capturar o pagamento. Tais altera\u00e7\u00f5es em um pagamento pr\u00e9-autorizado s\u00e3o chamadas de ajustes de autoriza\u00e7\u00e3o.\n\nNo momento, o ajuste de autoriza\u00e7\u00e3o est\u00e1 dispon\u00edvel para Discover, Mastercard e Visa. Em \u00faltima an\u00e1lise, o suporte depende do emissor.\n\nCasos de uso\nExistem v\u00e1rios casos de uso para ajustar uma quantidade pr\u00e9-autorizada:\n\n\nHospitalidade. Por exemplo, em um hotel\n\nNo momento do check-in, o hotel pr\u00e9-autoriza o pagamento do quarto que o h\u00f3spede reservou. Ao mesmo tempo, o hotel cria um token de reconhecimento do comprador, para poder aplicar cobran\u00e7as em atraso quando necess\u00e1rio.\nDurante a estadia, o h\u00f3spede incorre em despesas nas instala\u00e7\u00f5es do hotel. O hotel adiciona essas despesas ao valor pr\u00e9-autorizado, ajustando a autoriza\u00e7\u00e3o.\nNo momento do check-out, o hotel captura o valor final ou cancela o pagamento se o h\u00f3spede preferir pagar a conta com uma forma de pagamento diferente.\nSe necess\u00e1rio, o hotel cobra do h\u00f3spede ap\u00f3s a partida, usando o token de reconhecimento do comprador para um novo pagamento.\n\n\n\nGorjeta em regi\u00f5es e ind\u00fastrias em que \u00e9 habitual que o h\u00f3spede adicione uma dica no recibo ap\u00f3s a apresenta\u00e7\u00e3o do cart\u00e3o.\n\n\nAjuste ass\u00edncrono ou s\u00edncrono\nExistem duas maneiras de implementar a pr\u00e9-autoriza\u00e7\u00e3o:\n\n\nCom o ajuste de autoriza\u00e7\u00e3o ass\u00edncrona, voc\u00ea se refere a um pagamento usando a refer\u00eancia PSP que voc\u00ea recebeu na resposta \u00e0 sua solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o. Em cada solicita\u00e7\u00e3o de ajuste de autoriza\u00e7\u00e3o e na solicita\u00e7\u00e3o de captura final, voc\u00ea s\u00f3 precisa especificar esta primeira refer\u00eancia PSP.\nO ajuste ass\u00edncrono \u00e9 mais f\u00e1cil de implementar, mas n\u00e3o fica claro imediatamente se o ajuste foi bem-sucedido. Voc\u00ea precisa configurar as notifica\u00e7\u00f5es do webhook para receber atualiza\u00e7\u00f5es e saber se o valor final foi autorizado antes de capturar o pagamento.\n\n\nCom o ajuste de autoriza\u00e7\u00e3o s\u00edncrona, voc\u00ea passa um blob adjustAuthorisationData de um ajuste de autoriza\u00e7\u00e3o para o pr\u00f3ximo, para nos permitir acompanhar o valor mais recente. Voc\u00ea recebe o primeiro blob na resposta \u00e0 sua solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o. Na sua primeira solicita\u00e7\u00e3o de ajuste de autoriza\u00e7\u00e3o, voc\u00ea especifica o blob recebido para a pr\u00e9-autoriza\u00e7\u00e3o e recebe um novo blob na resposta. No seu pr\u00f3ximo ajuste, voc\u00ea especifica o blob que voc\u00ea recebeu na resposta do ajuste anterior e assim por diante.\nO ajuste s\u00edncrono requer uma etapa adicional para implementar, porque voc\u00ea precisa acompanhar o blob mais recente. A vantagem \u00e9 que voc\u00ea recebe o resultado do ajuste de forma s\u00edncrona. Dessa forma, voc\u00ea saber\u00e1 imediatamente se o valor final foi autorizado antes de capturar o pagamento.\n\nSe, em algum momento, voc\u00ea n\u00e3o conseguir passar no blob, o fluxo retornar\u00e1 ao ajuste ass\u00edncrono e n\u00e3o ser\u00e1 mais poss\u00edvel retornar ao ajuste s\u00edncrono para esse pagamento.\n\n\n\nAntes de voc\u00ea come\u00e7ar\nAntes de configurar e usar a pr\u00e9-autoriza\u00e7\u00e3o, certifique-se de:\n\nLer e entender nossos fundamentos da API de terminais.\nCriar uma integra\u00e7\u00e3o capaz de efetuar um pagamento.\nConfigurar as notifica\u00e7\u00f5es de webhook. Voc\u00ea precisar\u00e1 confiar nas notifica\u00e7\u00f5es para saber se a captura foi bem-sucedida. Se voc\u00ea usar o ajuste de autoriza\u00e7\u00e3o ass\u00edncrono, tamb\u00e9m precisar\u00e1 confiar em notifica\u00e7\u00f5es para o resultado do ajuste de autoriza\u00e7\u00e3o.\n\nLembre-se tamb\u00e9m de que voc\u00ea precisa implementar a l\u00f3gica do seu lado, por exemplo, para decidir quando usar o fluxo de pr\u00e9-autoriza\u00e7\u00e3o e calcular a quantia ao fazer um ajuste de autoriza\u00e7\u00e3o.\nEtapa 1 (opcional): configure sua conta\nH\u00e1 dois aspectos da sua conta que voc\u00ea pode querer configurar para pr\u00e9-autoriza\u00e7\u00e3o:\n\n\nAjuste de autoriza\u00e7\u00e3o s\u00edncrona: para receber os resultados do ajuste de autoriza\u00e7\u00e3o de forma s\u00edncrona, pe\u00e7a \u00e0 nossa Support Team para ativar isso.\n\n\nTipo de autoriza\u00e7\u00e3o padr\u00e3o: geralmente o tipo de autoriza\u00e7\u00e3o padr\u00e3o \u00e9 Final, o que significa que o pagamento \u00e9 capturado automaticamente quando autorizado. Como esse \u00e9 o padr\u00e3o, voc\u00ea n\u00e3o precisa especific\u00e1-lo em seus pedidos de pagamento. No entanto, com a pr\u00e9-autoriza\u00e7\u00e3o, voc\u00ea precisa especificar um tipo de autoriza\u00e7\u00e3o de PreAuth na sua solicita\u00e7\u00e3o de pagamento. Se voc\u00ea fizer apenas solicita\u00e7\u00f5es de pagamento com pr\u00e9-autoriza\u00e7\u00e3o, poder\u00e1 solicitar \u00e0 nossa Support Team que defina seu tipo de autoriza\u00e7\u00e3o padr\u00e3o como PreAuth para que voc\u00ea n\u00e3o precise especific\u00e1-lo nas solicita\u00e7\u00f5es de pagamento.\n\nSe voc\u00ea deseja fazer solicita\u00e7\u00f5es de pagamento com pr\u00e9-autoriza\u00e7\u00e3o e solicita\u00e7\u00f5es de pagamento normais, recomendamos que voc\u00ea especifique o tipo de autoriza\u00e7\u00e3o em todas as solicita\u00e7\u00f5es de pagamento.\n\n\n\nEtapa 2: pr\u00e9-autorizar um pagamento\nPara iniciar o fluxo de pagamento de pr\u00e9-autoriza\u00e7\u00e3o, fa\u00e7a um PaymentRequest com um tipo de autoriza\u00e7\u00e3o de PreAuth:\n\n\nFa\u00e7a uma solicita\u00e7\u00e3o POST para um endpoint da API de terminais, especificando:\n\n\nMessageHeader: Segue a estrutura MessageHeader padr\u00e3o, explicada nos fundamentos da API de terminais, que incluem:\n\nProtocolVersion: 3.0\nMessageClass: Service\nMessageCategory: Payment.\nMessageType: Request\nSaleID: Seu ID exclusivo para a caixa registradora.\nServiceID: Seu ID exclusivo para esta tentativa de transa\u00e7\u00e3o, consistindo em 1 a 10 caracteres alfanum\u00e9ricos. Esse valor precisa ser exclusivo nas \u00faltimas 48 horas.\nPOIID: : ID exclusivo do terminal. Isso indica para qual terminal o pagamento ser\u00e1 roteado.\n\n\n\n\nPaymentRequest: O corpo da solicita\u00e7\u00e3o da solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o deve incluir:\n\nSaleData.SaleTransactionID.TransactionID: Sua refer\u00eancia exclusiva para esta solicita\u00e7\u00e3o de pagamento.\nSaleData.SaleTransactionID.TimeStamp: Data e hora da solicita\u00e7\u00e3o de pagamento, no formato UTC.\nSaleData.SaleToAcquirerData:\n\nauthorisationType=PreAuth: indica que esta \u00e9 uma solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o.\nQuaisquer outros pares de valores-chave que voc\u00ea deseja passar, por exemplo, para fins de reconhecimento de clientes purposes.\n\nPaymentTransaction.AmountsReq.Currency: A moeda da transa\u00e7\u00e3o.\n\nPaymentTransaction.AmountsReq.RequestedAmount: O valor da transa\u00e7\u00e3o.\n\n\n\n\n\nO exemplo a seguir mostra como voc\u00ea iniciaria a pr\u00e9-autoriza\u00e7\u00e3o para um pagamento de EUR 150,00.\n\nPara obter mais informa\u00e7\u00f5es sobre a estrutura de solicita\u00e7\u00e3o da API de terminais, consulte os fundamentos da API de terminais.\n\n\n\n\nO cliente apresenta seu cart\u00e3o no terminal de pagamento. O terminal coleta os detalhes do pagamento e envia a solicita\u00e7\u00e3o do valor original \u00e0 plataforma de pagamentos da Adyen para processamento\nSe a pr\u00e9-autoriza\u00e7\u00e3o for bem sucedida:\n\nApproved \u00e9 exibido no visor do terminal.\n\nO resultado do pagamento cont\u00e9m:\n\n\nPOIData.POITransactionID.TransactionID: Identificador de transa\u00e7\u00e3o para o pagamento, no formato Tender_reference.PSP_reference.\n\n\nPaymentResult: Payment method data including:\n\n\nAmountsResp: O AuthorizedAmount e Currency do pagamento pr\u00e9-autorizado.\n\n\n\n\n\nResponse.Result: Success\n\n\nResponse.AdditionalResponse: Uma sequ\u00eancia base64. Quando decodificado, este \u00e9 um objeto JSON com dados de transa\u00e7\u00e3o adicionais. Isso inclui:\n\nposadditionalamounts.originalAmountValue: OMontante original em unidades menores.\nauthorisedAmountValue: Quantidade autorizada em unidades menores, que nesta fase \u00e9 igual \u00e0 quantidade original.\npspReference: A refer\u00eancia PSP da sua solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o.\nadjustAuthorisationData: Um blob codificado em URL.\n\n\n\n\n\nO exemplo a seguir mostra a resposta a uma solicita\u00e7\u00e3o de autoriza\u00e7\u00e3o de EUR 150,00.\n\n\n\n\n\nArmazene o arquivo pspReference da AdditionalResponse para uso posterior ao ajustar a autoriza\u00e7\u00e3o ou ao capturar o pagamento.\n\n\nSe voc\u00ea estiver usando o ajuste de autoriza\u00e7\u00e3o s\u00edncrona, decodifique o URL blob adjustAuthorisationData e o armazene.\n\n\nEtapa 3 (opcional): ajuste a pr\u00e9-autoriza\u00e7\u00e3o\nPara modificar o valor pr\u00e9-autorizado, fa\u00e7a uma solicita\u00e7\u00e3o de ajuste de autoriza\u00e7\u00e3o.\n\n\n \n \n \n \n\n\n\n\nEtapa 4: finalize o pagamento pr\u00e9-autorizado\nQuando voc\u00ea fiezer seu \u00faltimo ajuste de autoriza\u00e7\u00e3o, precisar\u00e1 capturar manualmente o pagamento para garantir que os fundos reservados sejam transferidos para sua conta:\n\nSempre verifique se voc\u00ea concluiu todos os ajustes de autoriza\u00e7\u00e3o para o pagamento antes de captur\u00e1-lo. As capturas s\u00e3o feitas de forma ass\u00edncrona, portanto, pode parecer que o pagamento ainda n\u00e3o foi capturado e ainda \u00e9 poss\u00edvel ajustar a autoriza\u00e7\u00e3o\n\n\n\n\nDecida se voc\u00ea est\u00e1 pronto para capturar o pagamento:\n\n\n\nExistem cobran\u00e7as adicionais a serem feitas?\nSe sim, ajuste a autoriza\u00e7\u00e3o primeiro (consulte a Etapa 3).\n\n\n\nO cliente deseja liquidar a fatura usando um m\u00e9todo de pagamento diferente daquele usado para a pr\u00e9-autoriza\u00e7\u00e3o?\nSe sim, n\u00e3o capture o pagamento. Em vez disso, cancele a pr\u00e9-autoriza\u00e7\u00e3o:\n\n\nFa\u00e7a uma solicita\u00e7\u00e3o \/payments\/{paymentPspReference}\/cancels especificando a pspReference da pr\u00e9-autoriza\u00e7\u00e3o original. Consulte Cancelar autoriza\u00e7\u00e3o para obter mais detalhes.\n\n\n\n\n\n\n\nQuando voc\u00ea estiver pronto para capturar o pagamento, fa\u00e7a uma solicita\u00e7\u00e3o POST para o endpoint do \/payments\/{paymentPspReference}\/captures ,\u00a0especificando:\n\npaymentPspReference: A pspReference da pr\u00e9-autoriza\u00e7\u00e3o original. Voc\u00ea recebeu isso na resposta \u00e0 sua solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o\namount: A currency e value do valor final em minor units. Essa \u00e9 a soma do valor original pr\u00e9-autorizado e de todos os ajustes posteriores.\nreference: Sua refer\u00eancia a esta modifica\u00e7\u00e3o de pagamento para uso em seu processo de reconcilia\u00e7\u00e3o.\nmerchantAccount: O nome da sua conta de comerciante usada para processar o pagamento.\n\n\n\n\n\n\nAo receber a resposta da captura, observe o seguinte:\n\npspReference: A refer\u00eancia PSP associada a esta solicita\u00e7\u00e3o\u00a0de captura. Observe que esta \u00e9 diferente da refer\u00eancia PSP associada \u00e0 solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o.\nstatus: received.\nreference: Sua refer\u00eancia a esta modifica\u00e7\u00e3o de pagamento para uso em seu processo de reconcilia\u00e7\u00e3o.\n\n\n\n\n\n\n\nAguarde a notifica\u00e7\u00e3o ass\u00edncrona. Isso informa se o valor final foi capturado.\nSe a captura for bem sucedida, esta notifica\u00e7\u00e3o conter\u00e1:\n\neventCode: CAPTURE\noriginalReference: O pspReference da pr\u00e9-autoriza\u00e7\u00e3o.\npspReference: A refer\u00eancia do PSP associada a esta solicita\u00e7\u00e3o\u00a0de captura.\nsuccess: true\n\n\n\nSe success for false, ent\u00e3o sua solicita\u00e7\u00e3o de captura falhou. Revise o reason que voc\u00ea recebeu na notifica\u00e7\u00e3o, corrija o problema e envie a solicita\u00e7\u00e3o de captura novamente.\n\n\n\n\nSe voc\u00ea precisar cobrar do h\u00f3spede uma quantia adicional ap\u00f3s a partida e tiver criado um token de reconhecimento de cliente com sua solicita\u00e7\u00e3o de pr\u00e9-autoriza\u00e7\u00e3o, poder\u00e1 aplicar essas cobran\u00e7as em atraso em uma solicita\u00e7\u00e3o de pagamento normal usando o token. Consulte Reconhecimento do cliente.\n\nVeja tamb\u00e9m\n\n\n Captura manual\n \n Ajustar autoriza\u00e7\u00e3o\n \n Reconhecimento do cliente\n \n Notifica\u00e7\u00e3o Webhook\n \n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Pr\u00e9-autoriza\u00e7\u00e3o"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"\/pt\/point-of-sale\/pre-authorisation"},"levels":3,"category":"In-person payments","category_color":"green","tags":["Pr\u00e9-autoriza\u00e7\u00e3o"]},"articleFiles":{"screen-EN_smart-pre-auth-funding-source-Compact_Touch.png":"
![\"\"](\"https:\/\/docs.adyen.com\/user\/pages\/docs\/03.point-of-sale\/31.pre-authorisation\/screen-EN_smart-pre-auth-funding-source-Compact_Touch.png\")
","screen-EN_smart-pre-auth.png":"![\"\"](\"https:\/\/docs.adyen.com\/user\/pages\/docs\/03.point-of-sale\/31.pre-authorisation\/screen-EN_smart-pre-auth.png\")
"}}
- \n Ajustar autoriza\u00e7\u00e3o\n <\/a><\/li>
- \n
- \n
- \n
- Decida se voc\u00ea est\u00e1 pronto para capturar o pagamento:<\/li>\n<\/ol>\n
- \n
- \n
- \n
- Quaisquer outros pares de valores-chave que voc\u00ea deseja passar, por exemplo, para fins de reconhecimento de clientes<\/a> purposes.<\/li>\n<\/ul><\/li>\n
- \n
- \n
- Criar uma integra\u00e7\u00e3o capaz de efetuar um pagamento<\/a>.<\/li>\n
- \n
- No momento do check-in, o hotel pr\u00e9-autoriza o pagamento do quarto que o h\u00f3spede reservou. Ao mesmo tempo, o hotel cria um token de reconhecimento do comprador<\/a>, para poder aplicar cobran\u00e7as em atraso quando necess\u00e1rio.<\/li>\n