- Credenciais de API
- Conta do comerciante
- Chave API
- Prefixo de URL da API
- Chave HMAC
Vai ligar a sua conta de comerciante Adyen ao TourTask: quatro valores, um webhook e um pagamento de teste. Precisa de uma conta Adyen de produção, não de teste, e obtê-la demora semanas.
Na Adyen, não pode criar a conta por si próprio. A Adyen não publica o valor mínimo de faturação: pergunte à equipa comercial. A maioria dos pequenos operadores fica mais bem servida com outro gateway de pagamento.
Obter uma conta Adyen de produção
- 1
Contacte a equipa comercial da Adyen
Use o formulário comercial da Adyen e diga que vende passeios. A Adyen trata os operadores turísticos como uma atividade restrita, com documentos adicionais e uma análise mais longa.
- 2
Pergunte pelo depósito de garantia antes de assinar
A Adyen pode reter parte dos valores que lhe transfere como depósito de garantia. Para passeios pagos com meses de antecedência, pode ser elevado.
Copiar os seus dados da Adyen
Inicie sessão na Customer Area de produção, ca-live.adyen.com, com um utilizador que tenha a função Merchant admin. Tenha cada valor à mão: preenche-os todos ao adicionar a Adyen no TourTask, depois do webhook.
- 1
Copie a conta de comerciante
Em Settings → Merchant accounts, copie o código da conta de comerciante, não o da conta da empresa. Vai para Conta do comerciante no TourTask.
- 2
Copie o prefixo do URL
Em Developers → API URLs, copie o Prefix: só o prefixo, não um endereço web completo. Vai para Prefixo de URL da API no TourTask.
- 3
Crie uma credencial de API
Selecione a conta da sua empresa, vá a Developers → API credentials e abra o separador Payments. Selecione Create new credential, escolha Web service user e depois Create credential.
- 4
Gere a chave de API
Em Server settings → Authentication, abra o separador API key e selecione Generate API key. A Adyen só mostra a chave uma vez: copie-a para Chave API no TourTask e depois selecione Save changes na Adyen.
Criar o webhook
Sem este webhook, os viajantes são cobrados, mas as reservas ficam por confirmar.
O seu endereço de webhook do TourTask para a Adyen
https://api.tourtask.com/v1/payments/adyen/notifications/booking- 1
Adicione um Standard webhook
Na Customer Area de produção, vá a Developers → Webhooks, selecione Create new webhook e depois Add ao lado de Standard webhook.
- 2
Ative-o para a sua conta de comerciante
Em General, ative Enabled e confirme que Merchant accounts inclui a sua.
- 3
Introduza o endereço do TourTask
Em Server configuration, cole o endereço do TourTask acima como URL.
- 4
Gere a chave HMAC
Em Security, selecione o ícone de edição ao lado de HMAC Key e depois Generate. A Adyen só mostra a chave uma vez: copie-a para Chave HMAC no TourTask.
- 5
Selecione Save configuration
Não use Test configuration a seguir: falha mesmo quando o webhook está correto.
Adicionar Adyen no TourTask
- 1
Abra o cartão Adyen
Vá a Configuração → Opções de pagamento e clique no cartão Adyen em Pagamentos online → Gateways de pagamento. Não aparece? Escolha Mostrar todos os gateways por baixo dos cartões.
- 2
Escolha o país e a moeda
Em País, escolha o país da sua conta Adyen e da respetiva conta bancária e, em Moeda, a moeda em que os viajantes pagam. Clique em Adicionar. Para alterar qualquer um deles mais tarde, remova Adyen com Remover e adicione-o de novo.
- 3
Preencha as suas credenciais de API
Em Autenticação, o cartão tem um campo para cada uma:
Conta do comerciante
Chave API
Prefixo de URL da API
Chave HMACCada campo é guardado quando clica fora dele.
- 4
Ative Adyen
Clique em Ativar quando todos os campos estiverem preenchidos. O cartão passa a Ativo e os viajantes podem pagar com Adyen na sua página de reserva. Cada pagamento entra diretamente na sua própria conta Adyen: o TourTask nunca retém o seu dinheiro.
Testar a Adyen
O TourTask não tem modo de teste para a Adyen, por isso teste com uma pequena reserva real que depois reembolsa.
- 1
Pague uma reserva
Reserve o seu passeio mais barato na sua própria página de reserva, escolha a Adyen e pague com o seu próprio cartão. De volta à sua página de reserva, a reserva confirma-se sozinha.
- 2
Reembolse o pagamento
Na reserva, escolha Reembolsar pagamento no menu de ações do pagamento e depois Reembolsar via Adyen.
Uma reserva cancelada não pode ser reembolsada através da Adyen.
- 3
Cancele a reserva de teste
Se o pagamento de teste falhar
- O pagamento falha de imediato: verifique se os quatro valores vêm da Customer Area de produção. Conta do comerciante tem de ser o código da conta de comerciante, não o da conta da empresa.
- Pagou, mas a reserva não está confirmada: na Customer Area de produção, verifique se o webhook está Enabled, inclui a sua conta de comerciante e tem o URL exatamente como acima. Se estiver tudo certo, gere uma nova HMAC Key no webhook e cole-a em Chave HMAC no TourTask. Depois, selecione Save configuration na Adyen.
Perguntas frequentes
Os que estiverem ativados para a sua conta de comerciante na Customer Area da Adyen. O TourTask não os filtra.
Normalmente, alguns dias. O TourTask regista o reembolso de imediato, e a sua Customer Area da Adyen mostra quando o dinheiro foi devolvido.
Não. O TourTask envia os viajantes para a página de pagamento da própria Adyen, por isso não há nada a configurar para isso.