Aqui descrevemos como implementar a gorjeta no seu fluxo de pagamento, em que a solicita\u00e7\u00e3o de pagamento que voc\u00ea envia da caixa registradora inclui um valor de gorjeta. O terminal mostra o valor original da transa\u00e7\u00e3o e o valor da gorjeta. O cliente usa o terminal para confirmar a gorjeta, alterar a quantia ou recusar dar uma gorjeta.<\/p>\n
Antes de implementar a gorjeta, certifique-se de:<\/p>\n
O valor da gorjeta a ser proposto ao cliente no terminal pode ser uma porcentagem do valor da transa\u00e7\u00e3o, um valor fixo, um dos v\u00e1rios valores fixados dependendo do valor da transa\u00e7\u00e3o e assim por diante.
\nVoc\u00ea precisa implementar a sua l\u00f3gica para garantir que a caixa registradora forne\u00e7a o valor da gorjeta que voc\u00ea precisa incluir em sua solicita\u00e7\u00e3o de pagamento.<\/p>\n
Depois de configurar a gorjeta na caixa registradora, voc\u00ea estar\u00e1 pronto para fazer uma solicita\u00e7\u00e3o de pagamento que inclua o Fa\u00e7a uma solicita\u00e7\u00e3o POST para um endpoint da API de termina<\/a>, especificando:<\/p>\n O exemplo abaixo mostra como voc\u00ea iniciaria um pagamento de EUR 142,50<\/strong> com uma gorjeta 10%<\/strong>.<\/p>\n Para 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 A solicita\u00e7\u00e3o de pagamento \u00e9 roteada para o terminal de pagamento. O cliente aceita, altera ou recusa a gorjeta e completa o pagamento. O terminal coleta os detalhes do pagamento e envia a solicita\u00e7\u00e3o do valor original da transa\u00e7\u00e3o mais o valor da gorjeta para a plataforma de pagamentos da Adyen.<\/p>\n Quando o pagamento for processado na plataforma de pagamentos da Adyen, voc\u00ea recebe o resultado do pagamento em uma resposta s\u00edncrona da API.<\/p>\n Se 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 O resultado do pagamento cont\u00e9m:<\/p>\nTipAmount<\/code>. Isso mostra o valor da transa\u00e7\u00e3o e o valor da gorjeta proposto no visor do terminal.<\/p>\n\n
\n
MessageHeader<\/code>: Segue a estrutura da MessageHeader<\/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>. Isso indica que voc\u00ea est\u00e1 iniciando uma solicita\u00e7\u00e3o de pagamento.<\/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>\nPaymentRequest<\/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>\nPaymentTransaction.AmountsReq.Currency<\/code>: A moeda<\/a> da transa\u00e7\u00e3o.<\/li>\nPaymentTransaction.AmountsReq.RequestedAmount<\/code>: O valor da transa\u00e7\u00e3o.<\/li>\nPaymentTransaction.AmountsReq.TipAmount<\/code>: O valor da gorjeta.<\/li>\n<\/ul>\n\n<\/li>\n<\/ul>\nEtapa 3: Receber o resultado do pagamento<\/h2>\n
\n