Durante uma transação, os terminais da Adyen geram notificações de exibição. Estas podem ser apresentadas em sua caixa registradora para manter os funcionários da loja atualizados sobre o andamento da transação.
Se sua integração usar comunicações em nuvem assíncronas, você precisará integrar as notificações de exibição para receber o resultado de suas transações.
Aqui, descrevemos como você expõe um endpoint no servidor e configura notificações de exibição. Seu servidor receberá webhooks que incluem um event. Isso pode indicar como o comprador está interagindo com o terminal ou o resultado da transação. Use-os para apresentar uma mensagem na sua caixa registradora.
Também fornecemos uma lista de valores event possíveis e exemplos de cada um.
Configurar notificações
Etapa 1: expor um terminal em seu servidor
As notificações de exibição são enviadas como retornos de chamada HTTP (webhooks) para um terminal no seu servidor. Para receber notificações, você precisa de um servidor que possua:
- Um endpoint que pode receber uma chamada JSON.
- Uma porta TCP aberta para tráfego HTTP (443, 8443 ou 8843).
Para teste, você também pode usar uma porta HTTP (80, 8080 ou 8888).
- Um nome de usuário e senha para autenticação básica.
Em seguida, insira os detalhes desse terminal na sua área de cliente.
Etapa 2: Configurar notificações em sua área de cliente
Digite os detalhes do seu servidor e selecione as informações adicionais que deseja receber nas notificações. Você pode configurar as notificações no nível de company account ou merchant account.
- Faça login na sua Customer Area. Para configurar notificações no nível de merchant accoout, mude para o nível de conta desejada.
- Va para Developers > Webhooks e selecione + Webhook.
- Ao lado de Terminal API details, clique em Add.
- Em Transport, insira o servidor:
- URL. Verifique se este é um URL publico.
- SSL (TLS) Version.
- Marque a caixa de seleção Active.
- Na seção Authentication digite o nome de usuário e a senha do servidor para autenticação básica.
Incluímos esses detalhes no cabeçalho da solicitação de notificação para autenticação no seu servidor. - Em Additional settings:
- Ative Display notification.
- Clique em Test Configuration para testar se a notificação foi recebida no seu terminal.
- Se o seu terminal recebeu a notificação, clique em Save Configuration.
As notificações de exibição agora serão enviadas para o endpoint especificado.
Tipos de notificações
Quando você recebe uma notificação, o tipo de notificação é indicado pelo event Quando você recebe uma notificação, o tipo de notificação é indicado pelo ReferenceID. Use event para apresentar uma mensagem aos funcionários da sua loja, informando-os do andamento da transação.
| Event | Descrição |
|---|---|
|
|
Tender foi criado com sucesso.Além do |
|
|
Os detalhes do cartão foram inseridos. |
|
|
O cliente inseriu o cartão no terminal.Para um exemplo desta notificação, consulte |
|
|
O cliente apresentou o cartão ao leitor sem contato do terminal. |
|
|
O cliente passou o cartão.Para um exemplo desta notificação, consulte |
|
|
O terminal está aguardando o comprador selecionar um aplicativo de pagamento.Para um exemplo desta notificação, consulte |
|
|
O cliente selecionou seu aplicativo de pagamento preferido.Para um exemplo desta notificação, consulte |
|
|
O terminal solicitou uma assinatura do comprador. |
|
|
O terminal está aguardando o comprador digitar seu PIN (senha).Para um exemplo desta notificação, consulte |
|
|
A assinatura foi verificada pela equipe da loja. |
|
|
O cliente inseriu um dígito de seu PIN (senha).Para um exemplo desta notificação, consulte |
|
|
O cliente terminou de digitar o PIN (senha).Para um exemplo desta notificação, consulte |
|
|
A assinatura foi verificada pela equipe da loja. |
|
|
O terminal está imprimindo o recibo..Para um exemplo desta notificação, consulte |
|
|
O terminal terminou de imprimir o recibo. |
|
|
O cliente removeu o cartão do terminal.Para um exemplo desta notificação, consulte |
|
|
Tender foi concluída (o comprador concluiu ou abandonou a transação). Além do |
|
|
O terminal está perguntando se o comprador exige conversão dinâmica de moeda. |
|
|
O terminal está aguardando uma possível gorjeta. |
|
|
Consulta de saldo concluída no terminal. |
|
|
Consulta de saldo iniciada no terminal.Para um exemplo desta notificação, consulte |
|
|
O cliente aceitou a solicitação de conversão de moeda dinâmica. |
|
|
O cliente rejeitou a solicitação de conversão de moeda dinâmica. |
|
|
O cliente inseriu uma gorjeta no terminal.Para um exemplo desta notificação, consulte |
|
|
O carregamento do vale-presente foi iniciado.Para um exemplo desta notificação, consulte |
|
|
A carga do vale-presente foi concluída. |
|
|
O terminal está aguardando que os detalhes do cartão sejam inseridos manualmente.Para um exemplo desta notificação, consulte |
Exemplos de notificações de exibição são fornecidos abaixo.