Definir op\u00e7\u00f5es de gorjeta<\/h3>\n
![\"\"](\"\/point-of-sale\/tipping\/tipping-from-terminal\/screen-EN_Tipping-predefined-options-portrait.png?resize=250;classes=caption\" "\\"Tipping")
<\/p>\n
Se voc\u00ea ativar a gorjeta sem definir as op\u00e7\u00f5es de gorjeta, a exibi\u00e7\u00e3o do terminal de pagamento mostrar\u00e1 um prompt simples para inserir o valor da gorjeta, al\u00e9m da op\u00e7\u00e3o 'sem gorjeta' para recusar a op\u00e7\u00e3o de gorjeta.<\/p>\n
Para facilitar a gorjeta, voc\u00ea pode predefinir ou calcular os valores das gorjetas que seu cliente pode selecionar no terminal. Para fazer isso, voc\u00ea precisa definir op\u00e7\u00f5es de gorjeta em um arquivo JSON:<\/p>\n
- \n
- As op\u00e7\u00f5es podem ser de um valor espec\u00edfico, de uma porcentagem da compra, uma 'gorjeta personalizada' ou 'sem gorjeta'.<\/li>\n
- A op\u00e7\u00e3o
no_tip<\/code> \u00e9 obrigat\u00f3ria.<\/li>\n- A op\u00e7\u00e3o
custom_tip<\/code> mostrar\u00e1 uma tela em que o cliente pode inserir um valor de gorjeta.<\/li>\n- Se a op\u00e7\u00e3o for para uma porcentagem, o display mostrar\u00e1 a porcentagem mais o valor calculado da gorjeta.<\/li>\n
- Recomendamos o uso de quatro op\u00e7\u00f5es junto com 'sem gorjeta' como a \u00faltima op\u00e7\u00e3o.<\/li>\n
- Voc\u00ea pode definir dois conjuntos de op\u00e7\u00f5es de gorjeta, abaixo e acima de um valor limite. O campo
limit<\/code> especifica esse limite. Se voc\u00ea deseja sempre as mesmas op\u00e7\u00f5es, especifique os mesmos valores nas matrizesbelow<\/code> eabove<\/code>.<\/li>\n- Voc\u00ea pode criar arquivos JSON diferentes para diferentes merchant accounts.<\/li>\n<\/ul>\n
Use o exemplo a seguir para criar seu arquivo JSON de op\u00e7\u00f5es de gorjeta.<\/p>\n
\n<\/code-sample>\n<\/div>\n Ativar gorjeta<\/h3>\n
Voc\u00ea precisa fazer algumas altera\u00e7\u00f5es em sua conta para ativar a gorjeta no terminal.<\/p>\n
- \n
- Entre em contato com a Support Team<\/a> e:\n
- \n
- Pe\u00e7a a eles para ativar a gorjeta para seus terminais.<\/li>\n
- Diga-lhes se deseja dar gorjeta antes ou depois<\/strong> da entrada do cart\u00e3o.\n
- \n
- Antes da entrada do cart\u00e3o: O terminal mostra o valor da transa\u00e7\u00e3o mais as op\u00e7\u00f5es de gorjeta e aguarda a resposta do cliente. Em seguida, o terminal solicita que o cliente apresente seu cart\u00e3o e forne\u00e7a seu PIN ou assinatura.<\/li>\n
- Ap\u00f3s a entrada do cart\u00e3o: O terminal mostra o valor da transa\u00e7\u00e3o e solicita ao cliente que apresente seu cart\u00e3o. Em seguida, o terminal mostra as op\u00e7\u00f5es de gorjeta e aguarda a resposta do cliente. Depois disso, o terminal solicita ao cliente que forne\u00e7a seu PIN ou assinatura.<\/li>\n<\/ul><\/li>\n
- Envie a eles seu arquivo JSON de op\u00e7\u00f5es de gorjeta, se desejar mostrar valores ou porcentagens de gorjeta predefinidas no terminal de pagamento.<\/li>\n<\/ul><\/li>\n<\/ul>\n
Mantenha sua equipe informada utilizando webhooks<\/h3>\n
Enquanto seu cliente estiver interagindo com o terminal, voc\u00ea poder\u00e1 apresentar mensagens de progresso em sua caixa registradora. Isso pode manter sua equipe informada sobre o valor da gorjeta.<\/p>\n
Essas mensagens s\u00e3o entregues usando notifica\u00e7\u00f5es de exibi\u00e7\u00e3o<\/em>, que s\u00e3o webhooks enviadas para um terminal especificado por voc\u00ea. Para obter informa\u00e7\u00f5es sobre como configurar e usar as notifica\u00e7\u00f5es de exibi\u00e7\u00e3o, consulte nossa documenta\u00e7\u00e3o de notifica\u00e7\u00f5es de exibi\u00e7\u00e3o<\/a>.<\/p>\n
Etapa 2: Efetuar um pagamento<\/h2>\n
Depois de configurar a gorjeta no terminal<\/a>, voc\u00ea estar\u00e1 pronto para fazer uma solicita\u00e7\u00e3o de pagamento com a tender option AskGratuity<\/strong>. Isso garante que o terminal apresente op\u00e7\u00f5es de gorjeta ao seu cliente.<\/p>\n
- \n
- \n
Fa\u00e7a uma solicita\u00e7\u00e3o POST para um endpoint da API do terminais<\/a>, especificando:<\/p>\n
- \n
- \n
MessageHeader<\/code>: Segue a estrutura daMessageHeader<\/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 para a solicita\u00e7\u00e3o de pagamento 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>\n- \n
SaleData.SaleToAcquirerData<\/code>: tenderOption=AskGratuity<\/strong> ou tenderOption=AskGratuity,ReceiptHandler<\/strong> que:<\/p>\n- \n
- \n
AskGratuity<\/code>: Dispara o terminal para mostrar as op\u00e7\u00f5es de gorjeta que voc\u00ea configurou.<\/p>\n\nSe voc\u00ea configurou a gorjeta no terminal, mas deseja fazer uma solicita\u00e7\u00e3o de pagamento sem mostrar a tela de gorjeta, omita a op\u00e7\u00e3o de solicita\u00e7\u00e3o AskGratuity<\/strong> da sua solicita\u00e7\u00e3o.<\/p>\n<\/div><\/div>\n<\/li>\n
- \n
ReceiptHandler<\/code>: Garante que a caixa registradora imprima o recibo. Omita esta op\u00e7\u00e3o de compra se o terminal de pagamento tiver uma impressora integrada e voc\u00ea desejar imprimir o recibo no terminal.<\/p>\n<\/li>\n<\/ul>\n<\/li>\nPaymentTransaction.AmountsReq.Currency<\/code>: A moeda<\/a> da transa\u00e7\u00e3o<\/li>\nPaymentTransaction.AmountsReq.RequestedAmount<\/code>: O valor da transa\u00e7\u00e3o.<\/li>\n<\/ul>\n\n<\/li>\n<\/ul>\nO exemplo abaixo mostra como voc\u00ea mostraria as op\u00e7\u00f5es de gorjeta e iniciaria uma transa\u00e7\u00e3o de EUR 142,50<\/strong>.<\/p>\n
\nPara obter mais informa\u00e7\u00f5es sobre a estrutura de solicita\u00e7\u00e3o da API do terminal, consulte os fundamentos da API de terminais<\/a>.<\/p>\n<\/div>\n
\n<\/code-sample>\n<\/div>\n<\/li>\n<\/ul>\n Quando o cliente seleciona uma op\u00e7\u00e3o de gorjeta e apresenta seu cart\u00e3o, o terminal de pagamento coleta os detalhes do pagamento e envia a solicita\u00e7\u00e3o do valor da transa\u00e7\u00e3o original mais o valor da gorjeta para a plataforma de pagamentos da Adyen.<\/p>\n
Etapa 3: Receber o resultado do pagamento<\/h2>\n
Quando o pagamento foi processado na plataforma de pagamentos da Adyen, voc\u00ea recebe o resultado do pagamento em uma resposta s\u00edncrona da API.<\/p>\n
\nSe sua integra\u00e7\u00e3o usar comunica\u00e7\u00e3o ass\u00edncrona em nuvem<\/a>, voc\u00ea receber\u00e1 o resultado em uma notifica\u00e7\u00e3o de exibi\u00e7\u00e3o TENDER_FINAL<\/a>.<\/p>\n<\/div>\n
Se o pagamento for bem-sucedido:<\/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.<\/p>\n<\/li>\n- \n
PaymentReceipt<\/code>: Receba dados com o valor original da transa\u00e7\u00e3o, o valor da gorjeta (n\u00e3o inclu\u00eddo se o cliente n\u00e3o tiver adicionado uma gorjeta) e o valor total.<\/p>\n<\/li>\n- \n
PaymentResult.AmountsResp<\/code>:<\/p>\n- \n
TipAmount<\/code>: Valor da gorjeta. Se o cliente n\u00e3o adicionou uma dica, esse campo n\u00e3o ser\u00e1 inclu\u00eddo.<\/li>\nAuthorizedAmount<\/code>: Valor total do pagamento (valor da transa\u00e7\u00e3o original mais valor da gorjeta).<\/li>\n- \n
Currency<\/code>: Moeda do pagamento.<\/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>: Valor da transa\u00e7\u00e3o original em minor units.<\/li>\nposAmountGratuityValue<\/code>: Valor da gorjeta em minor units.<\/li>\nauthorisedAmountValue<\/code>: Quantidade total autorizada em minor units.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\nO exemplo abaixo mostra a resposta para uma transa\u00e7\u00e3o de EUR 142,50<\/strong> com uma gorjeta de 10% adicionada.<\/p>\n
\n<\/code-sample>\n<\/div>\n<\/li>\n<\/ul>\n Veja tamb\u00e9m<\/h2>\n
\n- \n Fa\u00e7a um pagamento\n <\/a><\/li>
- \n Tender options\n <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/tipping\/tipping-from-terminal","articleFields":{"description":"Fa\u00e7a a implementa\u00e7\u00e3o para que o cliente adicione uma gorjeta diretamente no terminal.","last_edit_on":"03-06-2020 17:24"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/tipping\/tipping-from-terminal","title":"Gorjeta pelo terminal","content":"Aqui descrevemos como implementar a gorjeta no seu fluxo de pagamento, onde o terminal mostra op\u00e7\u00f5es de gorjeta predefinidas para o cliente escolher. Essas op\u00e7\u00f5es podem ser montantes fixos ou porcentagens do valor da transa\u00e7\u00e3o, ou ambos. Ap\u00f3s o cliente selecionar uma op\u00e7\u00e3o ou inserir um valor personalizado da gorjeta, o terminal envia o valor da transa\u00e7\u00e3o e o valor da gorjeta \u00e0 plataforma de pagamentos da Adyen para autoriza\u00e7\u00e3o. Dessa maneira, o valor total \u00e9 autorizado e capturado automaticamente.\nEtapa 1: Configurar a gorjeta no terminal\nAntes de poder fazer uma solicita\u00e7\u00e3o de pagamento que aciona o terminal para mostrar op\u00e7\u00f5es de gorjeta, ser\u00e1 necess\u00e1rio:\n\nDefinir op\u00e7\u00f5es de gorjeta\nHabilitar gorjeta\nOpcional: configure webhooks de notifica\u00e7\u00e3o de exibi\u00e7\u00e3o para manter sua equipe informada.\n\nDefinir op\u00e7\u00f5es de gorjeta\n\nSe voc\u00ea ativar a gorjeta sem definir as op\u00e7\u00f5es de gorjeta, a exibi\u00e7\u00e3o do terminal de pagamento mostrar\u00e1 um prompt simples para inserir o valor da gorjeta, al\u00e9m da op\u00e7\u00e3o 'sem gorjeta' para recusar a op\u00e7\u00e3o de gorjeta.\nPara facilitar a gorjeta, voc\u00ea pode predefinir ou calcular os valores das gorjetas que seu cliente pode selecionar no terminal. Para fazer isso, voc\u00ea precisa definir op\u00e7\u00f5es de gorjeta em um arquivo JSON:\n\nAs op\u00e7\u00f5es podem ser de um valor espec\u00edfico, de uma porcentagem da compra, uma 'gorjeta personalizada' ou 'sem gorjeta'.\nA op\u00e7\u00e3o no_tip \u00e9 obrigat\u00f3ria.\nA op\u00e7\u00e3o custom_tip mostrar\u00e1 uma tela em que o cliente pode inserir um valor de gorjeta.\nSe a op\u00e7\u00e3o for para uma porcentagem, o display mostrar\u00e1 a porcentagem mais o valor calculado da gorjeta.\nRecomendamos o uso de quatro op\u00e7\u00f5es junto com 'sem gorjeta' como a \u00faltima op\u00e7\u00e3o.\nVoc\u00ea pode definir dois conjuntos de op\u00e7\u00f5es de gorjeta, abaixo e acima de um valor limite. O campo limit especifica esse limite. Se voc\u00ea deseja sempre as mesmas op\u00e7\u00f5es, especifique os mesmos valores nas matrizes below e above.\nVoc\u00ea pode criar arquivos JSON diferentes para diferentes merchant accounts.\n\nUse o exemplo a seguir para criar seu arquivo JSON de op\u00e7\u00f5es de gorjeta.\n\n \n\nAtivar gorjeta\nVoc\u00ea precisa fazer algumas altera\u00e7\u00f5es em sua conta para ativar a gorjeta no terminal.\n\nEntre em contato com a Support Team e:\n\nPe\u00e7a a eles para ativar a gorjeta para seus terminais.\nDiga-lhes se deseja dar gorjeta antes ou depois da entrada do cart\u00e3o.\n\nAntes da entrada do cart\u00e3o: O terminal mostra o valor da transa\u00e7\u00e3o mais as op\u00e7\u00f5es de gorjeta e aguarda a resposta do cliente. Em seguida, o terminal solicita que o cliente apresente seu cart\u00e3o e forne\u00e7a seu PIN ou assinatura.\nAp\u00f3s a entrada do cart\u00e3o: O terminal mostra o valor da transa\u00e7\u00e3o e solicita ao cliente que apresente seu cart\u00e3o. Em seguida, o terminal mostra as op\u00e7\u00f5es de gorjeta e aguarda a resposta do cliente. Depois disso, o terminal solicita ao cliente que forne\u00e7a seu PIN ou assinatura.\n\nEnvie a eles seu arquivo JSON de op\u00e7\u00f5es de gorjeta, se desejar mostrar valores ou porcentagens de gorjeta predefinidas no terminal de pagamento.\n\n\nMantenha sua equipe informada utilizando webhooks\nEnquanto seu cliente estiver interagindo com o terminal, voc\u00ea poder\u00e1 apresentar mensagens de progresso em sua caixa registradora. Isso pode manter sua equipe informada sobre o valor da gorjeta.\nEssas mensagens s\u00e3o entregues usando notifica\u00e7\u00f5es de exibi\u00e7\u00e3o, que s\u00e3o webhooks enviadas para um terminal especificado por voc\u00ea. Para obter informa\u00e7\u00f5es sobre como configurar e usar as notifica\u00e7\u00f5es de exibi\u00e7\u00e3o, consulte nossa documenta\u00e7\u00e3o de notifica\u00e7\u00f5es de exibi\u00e7\u00e3o.\nEtapa 2: Efetuar um pagamento\nDepois de configurar a gorjeta no terminal, voc\u00ea estar\u00e1 pronto para fazer uma solicita\u00e7\u00e3o de pagamento com a tender option AskGratuity. Isso garante que o terminal apresente op\u00e7\u00f5es de gorjeta ao seu cliente.\n\n\nFa\u00e7a uma solicita\u00e7\u00e3o POST para um endpoint da API do terminais, especificando:\n\n\nMessageHeader: Segue a estrutura da 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 para a solicita\u00e7\u00e3o de pagamento 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 .\n\nSaleData.SaleToAcquirerData: tenderOption=AskGratuity ou tenderOption=AskGratuity,ReceiptHandler que:\n\n\nAskGratuity: Dispara o terminal para mostrar as op\u00e7\u00f5es de gorjeta que voc\u00ea configurou.\n\nSe voc\u00ea configurou a gorjeta no terminal, mas deseja fazer uma solicita\u00e7\u00e3o de pagamento sem mostrar a tela de gorjeta, omita a op\u00e7\u00e3o de solicita\u00e7\u00e3o AskGratuity da sua solicita\u00e7\u00e3o.\n\n\n\nReceiptHandler: Garante que a caixa registradora imprima o recibo. Omita esta op\u00e7\u00e3o de compra se o terminal de pagamento tiver uma impressora integrada e voc\u00ea desejar imprimir o recibo no terminal.\n\n\n\nPaymentTransaction.AmountsReq.Currency: A moeda da transa\u00e7\u00e3o\nPaymentTransaction.AmountsReq.RequestedAmount: O valor da transa\u00e7\u00e3o.\n\n\n\n\nO exemplo abaixo mostra como voc\u00ea mostraria as op\u00e7\u00f5es de gorjeta e iniciaria uma transa\u00e7\u00e3o de EUR 142,50.\n\nPara obter mais informa\u00e7\u00f5es sobre a estrutura de solicita\u00e7\u00e3o da API do terminal, consulte os fundamentos da API de terminais.\n\n\n\n\n\n\nQuando o cliente seleciona uma op\u00e7\u00e3o de gorjeta e apresenta seu cart\u00e3o, o terminal de pagamento coleta os detalhes do pagamento e envia a solicita\u00e7\u00e3o do valor da transa\u00e7\u00e3o original mais o valor da gorjeta para a plataforma de pagamentos da Adyen.\nEtapa 3: Receber o resultado do pagamento\nQuando o pagamento foi processado na plataforma de pagamentos da Adyen, voc\u00ea recebe o resultado do pagamento em uma resposta s\u00edncrona da API.\n\nSe sua integra\u00e7\u00e3o usar comunica\u00e7\u00e3o ass\u00edncrona em nuvem, voc\u00ea receber\u00e1 o resultado em uma notifica\u00e7\u00e3o de exibi\u00e7\u00e3o TENDER_FINAL.\n\nSe o pagamento for bem-sucedido:\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.\n\n\nPaymentReceipt: Receba dados com o valor original da transa\u00e7\u00e3o, o valor da gorjeta (n\u00e3o inclu\u00eddo se o cliente n\u00e3o tiver adicionado uma gorjeta) e o valor total.\n\n\nPaymentResult.AmountsResp:\n\nTipAmount: Valor da gorjeta. Se o cliente n\u00e3o adicionou uma dica, esse campo n\u00e3o ser\u00e1 inclu\u00eddo.\nAuthorizedAmount: Valor total do pagamento (valor da transa\u00e7\u00e3o original mais valor da gorjeta).\n\nCurrency: Moeda do pagamento.\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: Valor da transa\u00e7\u00e3o original em minor units.\nposAmountGratuityValue: Valor da gorjeta em minor units.\nauthorisedAmountValue: Quantidade total autorizada em minor units.\n\n\n\nO exemplo abaixo mostra a resposta para uma transa\u00e7\u00e3o de EUR 142,50 com uma gorjeta de 10% adicionada.\n\n\n\n\n\nVeja tamb\u00e9m\n\n\n Fa\u00e7a um pagamento\n \n Tender options\n \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Gorjeta","lvl3":"Gorjeta pelo terminal"},"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\/tipping","lvl3":"\/pt\/point-of-sale\/tipping\/tipping-from-terminal"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Gorjeta","terminal"]},"articleFiles":{"screen-EN_Tipping-Enter-total-amount-Error.png":"
![\"\"](\"https:\/\/docs.adyen.com\/user\/pages\/docs\/03.point-of-sale\/28.tipping\/02.tipping-from-terminal\/screen-EN_Tipping-Enter-total-amount-Error.png\")
","screen-EN_Tipping-Enter-total-amount-SEK.png":"![\"\"](\"https:\/\/docs.adyen.com\/user\/pages\/docs\/03.point-of-sale\/28.tipping\/02.tipping-from-terminal\/screen-EN_Tipping-Enter-total-amount-SEK.png\")
","screen-EN_Tipping-Enter-total-amount.png":"![\"\"](\"https:\/\/docs.adyen.com\/user\/pages\/docs\/03.point-of-sale\/28.tipping\/02.tipping-from-terminal\/screen-EN_Tipping-Enter-total-amount.png\")
","configure-tipping-MAPI.js":"configure-tipping-MAPI.js<\/p>"}}
- \n Tender options\n <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/tipping\/tipping-from-terminal","articleFields":{"description":"Fa\u00e7a a implementa\u00e7\u00e3o para que o cliente adicione uma gorjeta diretamente no terminal.","last_edit_on":"03-06-2020 17:24"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/tipping\/tipping-from-terminal","title":"Gorjeta pelo terminal","content":"Aqui descrevemos como implementar a gorjeta no seu fluxo de pagamento, onde o terminal mostra op\u00e7\u00f5es de gorjeta predefinidas para o cliente escolher. Essas op\u00e7\u00f5es podem ser montantes fixos ou porcentagens do valor da transa\u00e7\u00e3o, ou ambos. Ap\u00f3s o cliente selecionar uma op\u00e7\u00e3o ou inserir um valor personalizado da gorjeta, o terminal envia o valor da transa\u00e7\u00e3o e o valor da gorjeta \u00e0 plataforma de pagamentos da Adyen para autoriza\u00e7\u00e3o. Dessa maneira, o valor total \u00e9 autorizado e capturado automaticamente.\nEtapa 1: Configurar a gorjeta no terminal\nAntes de poder fazer uma solicita\u00e7\u00e3o de pagamento que aciona o terminal para mostrar op\u00e7\u00f5es de gorjeta, ser\u00e1 necess\u00e1rio:\n\nDefinir op\u00e7\u00f5es de gorjeta\nHabilitar gorjeta\nOpcional: configure webhooks de notifica\u00e7\u00e3o de exibi\u00e7\u00e3o para manter sua equipe informada.\n\nDefinir op\u00e7\u00f5es de gorjeta\n\nSe voc\u00ea ativar a gorjeta sem definir as op\u00e7\u00f5es de gorjeta, a exibi\u00e7\u00e3o do terminal de pagamento mostrar\u00e1 um prompt simples para inserir o valor da gorjeta, al\u00e9m da op\u00e7\u00e3o 'sem gorjeta' para recusar a op\u00e7\u00e3o de gorjeta.\nPara facilitar a gorjeta, voc\u00ea pode predefinir ou calcular os valores das gorjetas que seu cliente pode selecionar no terminal. Para fazer isso, voc\u00ea precisa definir op\u00e7\u00f5es de gorjeta em um arquivo JSON:\n\nAs op\u00e7\u00f5es podem ser de um valor espec\u00edfico, de uma porcentagem da compra, uma 'gorjeta personalizada' ou 'sem gorjeta'.\nA op\u00e7\u00e3o no_tip \u00e9 obrigat\u00f3ria.\nA op\u00e7\u00e3o custom_tip mostrar\u00e1 uma tela em que o cliente pode inserir um valor de gorjeta.\nSe a op\u00e7\u00e3o for para uma porcentagem, o display mostrar\u00e1 a porcentagem mais o valor calculado da gorjeta.\nRecomendamos o uso de quatro op\u00e7\u00f5es junto com 'sem gorjeta' como a \u00faltima op\u00e7\u00e3o.\nVoc\u00ea pode definir dois conjuntos de op\u00e7\u00f5es de gorjeta, abaixo e acima de um valor limite. O campo limit especifica esse limite. Se voc\u00ea deseja sempre as mesmas op\u00e7\u00f5es, especifique os mesmos valores nas matrizes below e above.\nVoc\u00ea pode criar arquivos JSON diferentes para diferentes merchant accounts.\n\nUse o exemplo a seguir para criar seu arquivo JSON de op\u00e7\u00f5es de gorjeta.\n\n \n\nAtivar gorjeta\nVoc\u00ea precisa fazer algumas altera\u00e7\u00f5es em sua conta para ativar a gorjeta no terminal.\n\nEntre em contato com a Support Team e:\n\nPe\u00e7a a eles para ativar a gorjeta para seus terminais.\nDiga-lhes se deseja dar gorjeta antes ou depois da entrada do cart\u00e3o.\n\nAntes da entrada do cart\u00e3o: O terminal mostra o valor da transa\u00e7\u00e3o mais as op\u00e7\u00f5es de gorjeta e aguarda a resposta do cliente. Em seguida, o terminal solicita que o cliente apresente seu cart\u00e3o e forne\u00e7a seu PIN ou assinatura.\nAp\u00f3s a entrada do cart\u00e3o: O terminal mostra o valor da transa\u00e7\u00e3o e solicita ao cliente que apresente seu cart\u00e3o. Em seguida, o terminal mostra as op\u00e7\u00f5es de gorjeta e aguarda a resposta do cliente. Depois disso, o terminal solicita ao cliente que forne\u00e7a seu PIN ou assinatura.\n\nEnvie a eles seu arquivo JSON de op\u00e7\u00f5es de gorjeta, se desejar mostrar valores ou porcentagens de gorjeta predefinidas no terminal de pagamento.\n\n\nMantenha sua equipe informada utilizando webhooks\nEnquanto seu cliente estiver interagindo com o terminal, voc\u00ea poder\u00e1 apresentar mensagens de progresso em sua caixa registradora. Isso pode manter sua equipe informada sobre o valor da gorjeta.\nEssas mensagens s\u00e3o entregues usando notifica\u00e7\u00f5es de exibi\u00e7\u00e3o, que s\u00e3o webhooks enviadas para um terminal especificado por voc\u00ea. Para obter informa\u00e7\u00f5es sobre como configurar e usar as notifica\u00e7\u00f5es de exibi\u00e7\u00e3o, consulte nossa documenta\u00e7\u00e3o de notifica\u00e7\u00f5es de exibi\u00e7\u00e3o.\nEtapa 2: Efetuar um pagamento\nDepois de configurar a gorjeta no terminal, voc\u00ea estar\u00e1 pronto para fazer uma solicita\u00e7\u00e3o de pagamento com a tender option AskGratuity. Isso garante que o terminal apresente op\u00e7\u00f5es de gorjeta ao seu cliente.\n\n\nFa\u00e7a uma solicita\u00e7\u00e3o POST para um endpoint da API do terminais, especificando:\n\n\nMessageHeader: Segue a estrutura da 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 para a solicita\u00e7\u00e3o de pagamento 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 .\n\nSaleData.SaleToAcquirerData: tenderOption=AskGratuity ou tenderOption=AskGratuity,ReceiptHandler que:\n\n\nAskGratuity: Dispara o terminal para mostrar as op\u00e7\u00f5es de gorjeta que voc\u00ea configurou.\n\nSe voc\u00ea configurou a gorjeta no terminal, mas deseja fazer uma solicita\u00e7\u00e3o de pagamento sem mostrar a tela de gorjeta, omita a op\u00e7\u00e3o de solicita\u00e7\u00e3o AskGratuity da sua solicita\u00e7\u00e3o.\n\n\n\nReceiptHandler: Garante que a caixa registradora imprima o recibo. Omita esta op\u00e7\u00e3o de compra se o terminal de pagamento tiver uma impressora integrada e voc\u00ea desejar imprimir o recibo no terminal.\n\n\n\nPaymentTransaction.AmountsReq.Currency: A moeda da transa\u00e7\u00e3o\nPaymentTransaction.AmountsReq.RequestedAmount: O valor da transa\u00e7\u00e3o.\n\n\n\n\nO exemplo abaixo mostra como voc\u00ea mostraria as op\u00e7\u00f5es de gorjeta e iniciaria uma transa\u00e7\u00e3o de EUR 142,50.\n\nPara obter mais informa\u00e7\u00f5es sobre a estrutura de solicita\u00e7\u00e3o da API do terminal, consulte os fundamentos da API de terminais.\n\n\n\n\n\n\nQuando o cliente seleciona uma op\u00e7\u00e3o de gorjeta e apresenta seu cart\u00e3o, o terminal de pagamento coleta os detalhes do pagamento e envia a solicita\u00e7\u00e3o do valor da transa\u00e7\u00e3o original mais o valor da gorjeta para a plataforma de pagamentos da Adyen.\nEtapa 3: Receber o resultado do pagamento\nQuando o pagamento foi processado na plataforma de pagamentos da Adyen, voc\u00ea recebe o resultado do pagamento em uma resposta s\u00edncrona da API.\n\nSe sua integra\u00e7\u00e3o usar comunica\u00e7\u00e3o ass\u00edncrona em nuvem, voc\u00ea receber\u00e1 o resultado em uma notifica\u00e7\u00e3o de exibi\u00e7\u00e3o TENDER_FINAL.\n\nSe o pagamento for bem-sucedido:\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.\n\n\nPaymentReceipt: Receba dados com o valor original da transa\u00e7\u00e3o, o valor da gorjeta (n\u00e3o inclu\u00eddo se o cliente n\u00e3o tiver adicionado uma gorjeta) e o valor total.\n\n\nPaymentResult.AmountsResp:\n\nTipAmount: Valor da gorjeta. Se o cliente n\u00e3o adicionou uma dica, esse campo n\u00e3o ser\u00e1 inclu\u00eddo.\nAuthorizedAmount: Valor total do pagamento (valor da transa\u00e7\u00e3o original mais valor da gorjeta).\n\nCurrency: Moeda do pagamento.\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: Valor da transa\u00e7\u00e3o original em minor units.\nposAmountGratuityValue: Valor da gorjeta em minor units.\nauthorisedAmountValue: Quantidade total autorizada em minor units.\n\n\n\nO exemplo abaixo mostra a resposta para uma transa\u00e7\u00e3o de EUR 142,50 com uma gorjeta de 10% adicionada.\n\n\n\n\n\nVeja tamb\u00e9m\n\n\n Fa\u00e7a um pagamento\n \n Tender options\n \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Gorjeta","lvl3":"Gorjeta pelo terminal"},"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\/tipping","lvl3":"\/pt\/point-of-sale\/tipping\/tipping-from-terminal"},"levels":4,"category":"In-person payments","category_color":"green","tags":["Gorjeta","terminal"]},"articleFiles":{"screen-EN_Tipping-Enter-total-amount-Error.png":"
- \n
- \n
- \n
- \n
- \n
- A op\u00e7\u00e3o