Configura a tua plataforma de pagamento premium
As plataformas de pagamento premium integradas com a Avantio permitem automatizar as cobranças associadas às tuas reservas e processar transações de forma segura.
O procedimento de ligação varia consoante o fornecedor. Em alguns casos, terás de criar previamente uma conta e concluir o onboarding diretamente com a plataforma. Noutros, será necessário pedir determinadas credenciais ou links de ligação à equipa de Customer Experience da Avantio.
Neste artigo vais encontrar o processo de integração de cada fornecedor, os dados necessários e os prazos indicativos de ativação.
O que vais aprender neste artigo?
Neste artigo vais aprender a:
Preparar a informação necessária antes de iniciares uma ligação.
Concluir o onboarding com o fornecedor de pagamentos.
Pedir à Avantio os links ou identificadores necessários.
Fornecer corretamente as credenciais de integração.
Verificar a ligação através de uma reserva de teste.
Identificar os principais erros durante o processo.
Vantagens
Ligar uma plataforma de pagamento premium vai permitir-te:
Automatizar as cobranças relacionadas com as reservas.
Reduzir a intervenção manual da equipa.
Centralizar a configuração dos pagamentos.
Reforçar a segurança através de sistemas como o 3D Secure.
Melhorar a rastreabilidade das transações.
Facilitar o acompanhamento de cobranças, devoluções e incidentes.
Adaptar a solução de pagamento ao país onde a tua empresa opera.
Quando deves fazer esta configuração?
Deves fazer esta configuração quando:
Já escolheste a plataforma de pagamento que a tua empresa vai utilizar.
Confirmaste que o fornecedor opera no teu país.
Queres começar a processar cobranças de reservas através da nova plataforma.
Precisas substituir uma gateway utilizada anteriormente.
Queres automatizar pagamentos que atualmente geres manualmente.
O fornecedor já aprovou a conta da tua empresa.
Antes de começares
Convém rever previamente:
Se a plataforma selecionada está disponível no teu país.
Se contrataste o serviço diretamente com o fornecedor.
Se a conta está registada em nome da empresa correta.
Se já concluíste as verificações legais e bancárias solicitadas.
Se tens acesso administrativo à conta.
Se tens preparados os dados e credenciais necessários.
Se sabes que empresa, escritórios ou alojamentos vão usar a ligação.
Se a pessoa responsável pela configuração tem permissões suficientes na Avantio.
Também é recomendável definir internamente quem ficará responsável por rever as cobranças, devoluções, reconciliações e eventuais incidentes.
Nunca envies credenciais sensíveis por canais não autorizados. Quando for necessário fornecer dados à Avantio, fá-lo através de um ticket dirigido à equipa de Customer Experience.
Liga a tua plataforma premium escolhida à Avantio
Comercia Global Payments
Comercia Global Payments
Antes de começares
Para utilizares a Comercia Global Payments deves iniciar primeiro o processo de contratação e onboarding diretamente com a Comercia.
Segue estes passos
Contacta a Comercia Global Payments através do teu contacto comercial.
Indica que queres utilizar a Comercia Global Payments com a Avantio.
Fornece a documentação empresarial e bancária solicitada.
Conclui o processo de onboarding com a Comercia.
Aguarda que a Comercia valide e aprove a conta.
A Comercia irá contactar a Avantio para fornecer os dados necessários para a integração.
Confirma com a equipa de Customer Experience da Avantio que o pedido está em curso.
Quando a ligação estiver disponível, faz uma reserva de teste.
Verifica se a transação aparece corretamente na Avantio e na interface da Comercia.
Tempo de ativação
O processo costuma ficar concluído em cerca de uma semana, embora o prazo possa variar consoante a documentação e validações necessárias durante o onboarding.
Stripe
Stripe
Antes de começares
Para ligares o Stripe precisas de:
Uma conta Stripe do tipo Standard.
Ter concluído o processo de verificação solicitado pelo Stripe.
Acesso à conta com permissões suficientes.
Um link de ligação fornecido pela Avantio.
Segue estes passos
Acede à página do Stripe e cria uma conta do tipo Standard.
Preenche os dados empresariais, fiscais e bancários solicitados.
Conclui o processo de verificação da conta.
Cria um ticket para a equipa de Customer Experience da Avantio.
Indica no ticket que queres ligar a tua conta Standard do Stripe.
Aguarda para receber o link de ligação.
Abre o link e inicia sessão com a conta Stripe correspondente.
Autoriza a ligação entre o Stripe e a Avantio.
Confirma com a equipa de Customer Experience que o processo foi concluído.
Faz uma reserva de teste e verifica se o pagamento é processado corretamente.
Tempo de ativação
A ligação pode ficar ativa no próprio dia, desde que a conta Standard do Stripe esteja verificada e pronta a operar.
SysPay
SysPay
Antes de começares
Para iniciares a ligação com a SysPay deves concluir o processo de onboarding deles.
Durante este processo, a SysPay vai pedir dois identificadores que devem ser fornecidos pela Avantio:
Account ID.
Merchant ID.
Segue estes passos
Contacta a equipa comercial da SysPay.
Indica que queres usar a integração deles com a Avantio.
Fornece à SysPay a documentação empresarial e bancária solicitada.
Cria um ticket para a equipa de Customer Experience da Avantio.
Pede o teu Account ID e Merchant ID para a ligação com a SysPay.
Fornece estes dois identificadores à SysPay.
Conclui as verificações pendentes com o fornecedor.
Aguarda que a SysPay ative o módulo de processamento de pagamentos via API.
Quando a SysPay confirmar que o módulo está pronto, informa a equipa de Customer Experience da Avantio através do ticket.
A Avantio irá concluir a configuração da integração.
Faz uma reserva de teste.
Verifica se a transação é processada e aparece corretamente em ambas as plataformas.
Tempo de ativação
A ativação costuma demorar alguns dias, dependendo do tempo necessário para concluir o onboarding e ativar o módulo de pagamentos via API.
Mercado Pago
Mercado Pago
Antes de começares
Para ligares o Mercado Pago precisas de:
Uma conta de empresa ativa.
Acesso à secção de integrações.
O User ID da conta.
A chave secreta configurada para os webhooks.
O Access Token de produção.
O URL de webhook fornecido pela Avantio.
Segue estes passos
Inicia sessão na tua conta de empresa do Mercado Pago.
Acede à secção O teu negócio.
Seleciona Integrações.
Procura o painel de aplicações conectadas.
Acede à aplicação que vais usar para a ligação com a Avantio.
Procura o campo User ID.
Copia o valor e guarda-o num local seguro.
Cria um ticket para a equipa de Customer Experience da Avantio.
Pede o URL que deves usar para configurar os webhooks.
Volta ao Mercado Pago e acede à secção Webhooks.
Introduz o URL fornecido pela Avantio.
Na secção de eventos, seleciona Pagamentos.
Procura o campo Chave secreta.
Copia o valor correspondente à chave secreta dos webhooks.
Acede a Credenciais de produção.
Procura o campo Access Token.
Copia o valor e guarda-o em segurança.
Verifica se tens os seguintes dados:
User ID.
Webhooks Secret Key.
Access Token.
Fornece estes dados à equipa de Customer Experience da Avantio através do ticket e do canal seguro indicado.
Aguarda que a Avantio introduza as credenciais no assistente de ligação.
Quando a configuração estiver concluída, faz uma reserva de teste.
Verifica se a cobrança é processada e registada corretamente.
Tempo de ativação
A ativação pode ser imediata assim que a Avantio recebe as credenciais corretas e conclui a configuração.
Depois da ativação, é necessário fazer uma reserva de teste para confirmar que as cobranças funcionam corretamente.
Tilopay
Tilopay
Antes de começar
Para ligares o Tilopay precisas primeiro de concluir o processo de onboarding e obter as credenciais de produção.
Os dados necessários são:
Tilopay Key.
Tilopay Password.
Tilopay Proxy Key.
Tilopay User.
Também terás de escolher o modo de operação que vais utilizar.
Modos de operação disponíveis
3DS v.2
Neste modo, o hóspede terá de autorizar através do 3D Secure cada um dos pagamentos associados à reserva.
Pode ser adequado quando pretendes que todos os pagamentos exijam autenticação individual pelo titular do cartão.
E-commerce: CIT e MIT
Neste modo, o hóspede autoriza através do 3D Secure o primeiro pagamento.
Os pagamentos seguintes associados à reserva podem ser processados automaticamente como operações iniciadas pelo comerciante, desde que sejam cumpridas as condições definidas pelo fornecedor.
Pode ser adequado para reservas com vários vencimentos ou pagamentos fracionados.
Segue estes passos
Contacta diretamente o Tilopay para iniciar o processo de onboarding.
Indica que vais utilizar a integração com a Avantio.
Fornece a documentação empresarial e bancária solicitada.
Conclui as verificações pedidas pelo Tilopay.
Confirma com o Tilopay qual o modo de operação mais adequado para a tua empresa: 3DS v.2 ou E-commerce com CIT e MIT.
Pede as credenciais de produção.
Verifica que tens a Tilopay Key, Tilopay Password, Tilopay Proxy Key e Tilopay User.
Cria um ticket para a equipa de Customer Experience da Avantio.
Inclui as credenciais necessárias através do canal seguro indicado pela equipa.
Indica o modo de operação escolhido.
Aguarda que a Avantio faça a configuração da integração.
Faz uma reserva de teste.
Verifica o primeiro pagamento e, quando aplicável, o funcionamento dos pagamentos seguintes.
Tempo de ativação
A ativação costuma ficar concluída em poucos dias, dependendo do tempo necessário para terminar o onboarding e obter as credenciais.
Ascent Payment Solutions
Ascent Payment Solutions
Antes de começar
Para ligares o Ascent Payment Solutions precisas de concluir o processo de onboarding e ter as seguintes credenciais:
Client ID.
Site ID.
Key.
Password.
Price ID.
Segue estes passos
Contacta diretamente o Ascent Payment Solutions.
Indica que pretendes utilizar a integração com a Avantio.
Conclui o processo de contratação e onboarding.
Fornece a documentação empresarial e bancária solicitada.
Aguarda que o Ascent aprove a conta e gere as credenciais.
Verifica que tens o Client ID, Site ID, Key, Password e Price ID.
Cria um ticket para a equipa de Customer Experience da Avantio.
Fornece as credenciais através do canal seguro indicado.
Aguarda que a Avantio conclua a configuração.
Faz uma reserva de teste.
Verifica que o pagamento aparece corretamente tanto na Avantio como na interface do Ascent.
Tempo de ativação
A ligação costuma ficar concluída em poucos dias, dependendo do progresso do processo de onboarding com o Ascent.
Resultado esperado
Ao completares o processo correspondente ao teu fornecedor:
A plataforma de pagamento ficará ligada à Avantio.
Poderás processar os pagamentos associados às reservas.
As transações serão enviadas para a plataforma configurada.
Poderás consultar os movimentos a partir da Avantio e, quando aplicável, a partir do painel do fornecedor.
Os pagamentos utilizarão as medidas de segurança e autenticação disponíveis na plataforma.
A integração só deve ser considerada concluída depois de realizares e verificares corretamente uma reserva de teste.
Próximos passos recomendados
Depois de ativares a ligação:
Faz uma reserva de teste com um valor reduzido.
Verifica que o pagamento é registado corretamente na Avantio.
Confirma que a transação aparece na plataforma de pagamento.
Verifica o estado do pagamento e a moeda utilizada.
Confirma o funcionamento do 3D Secure.
Verifica os pagamentos seguintes se trabalhas com pagamentos fracionados.
Faz um reembolso de teste quando o fornecedor o permitir.
Confirma que membros da equipa têm acesso ao painel de pagamentos.
Documenta internamente o procedimento para gerir incidentes e chargebacks.
Informa a equipa antes de começares a processar reservas reais.
Principais dados e credenciais
Consoante o fornecedor, podes precisar dos seguintes elementos:
Stripe: conta Standard e link de ligação.
Comercia Global Payments: conta aprovada e dados geridos diretamente entre a Comercia e a Avantio.
Tilopay: Tilopay Key, Tilopay Password, Tilopay Proxy Key e Tilopay User.
Ascent Payment Solutions: Client ID, Site ID, Key, Password e Price ID.
SysPay: Account ID e Merchant ID.
Mercado Pago: User ID, Webhooks Secret Key e Access Token.
Trata sempre estas credenciais como informação confidencial.
Limitações e considerações
Tem em conta que:
A Avantio não pode concluir a integração até que o fornecedor aprove a conta.
Os prazos de ativação são indicativos.
A documentação solicitada depende do fornecedor e do país.
As credenciais devem ser do ambiente de produção, salvo indicação em contrário.
Uma credencial incompleta, expirada ou copiada incorretamente pode impedir a ligação.
A integração pode exigir a participação tanto do fornecedor como da Avantio.
Algumas operações devem ser geridas a partir do painel externo da plataforma.
A ativação técnica não garante que todos os métodos de pagamento estejam ativos.
A configuração do 3D Secure pode variar consoante a plataforma e o modo de operação.
Os pagamentos seguintes podem exigir uma configuração específica.
Não deves começar a processar pagamentos reais sem teres feito um teste.
Antes de mudares uma plataforma que já está em uso, verifica o impacto sobre as reservas existentes e os pagamentos ainda pendentes.
Boas práticas
Utiliza uma conta empresarial e não uma conta pessoal.
Conclui o onboarding antes de pedires a ativação na Avantio.
Verifica cuidadosamente cada credencial antes de a enviares.
Não partilhes palavras-passe nem tokens em canais não autorizados.
Mantém atualizado o contacto administrativo da plataforma.
Limita o acesso apenas a quem realmente precisa de gerir pagamentos.
Ativa a autenticação em dois passos no painel do fornecedor, quando disponível.
Faz sempre uma reserva de teste.
Verifica tanto o primeiro pagamento como os seguintes.
Revisa periodicamente as transações rejeitadas.
Documenta internamente o processo de reembolso e chargeback.
Informa a Avantio e o fornecedor se alterares a conta bancária, a entidade legal ou as credenciais.
Evita substituir uma ligação ativa durante períodos com muitos pagamentos pendentes.
Caso prático
Uma empresa decide utilizar o Tilopay para gerir reservas com vários pagamentos.
A empresa conclui o onboarding e escolhe o modo E-commerce com CIT e MIT, pois pretende que o hóspede autorize o primeiro pagamento através do 3D Secure e que os pagamentos seguintes sejam processados automaticamente.
Depois de receber as credenciais de produção, a empresa fornece à Avantio a Tilopay Key, Tilopay Password, Tilopay Proxy Key e Tilopay User.
A Avantio conclui a configuração e a empresa faz uma reserva de teste com dois vencimentos. Primeiro verifica a autenticação do pagamento inicial e, depois, confirma que o segundo pagamento é processado conforme a configuração acordada.
Só depois de validar ambos os pagamentos é que começa a utilizar a integração com reservas reais.
Erros frequentes
Não é possível ativar a ligação
Verifica se a conta está totalmente aprovada pelo fornecedor e se concluíste todas as verificações pendentes.
As credenciais não são válidas
Confirma que copiaste todos os valores completos, sem espaços extra, quebras de linha ou caracteres em falta.
Garante também que são credenciais de produção e não de um ambiente de testes.
O pagamento não aparece na plataforma
Verifica se a reserva utiliza a plataforma correta e se a transação foi realmente enviada.
Confirma também o estado do pagamento e possíveis mensagens de erro.
O 3D Secure não aparece
A autenticação pode depender do tipo de cartão, do país, do emissor e da configuração da plataforma.
Confirma com o fornecedor se o 3D Secure está ativo na conta.
Pagamentos posteriores não são processados
Verifica se a plataforma e o modo de operação permitem efetuar cobranças posteriores.
Na Tilopay, confirma se o modo E-commerce está configurado com CIT e MIT quando necessário.
O Mercado Pago não recebe as notificações
Verifica que:
O URL do webhook está correto.
O evento Pagos está selecionado.
A chave secreta é válida.
As credenciais de produção estão ativas.
O SysPay não conclui a ativação
Confirma que o SysPay recebeu o Account ID e o Merchant ID corretos.
Quando o SysPay ativar o módulo API, avisa a Avantio para podermos concluir a integração.
Se algo não funcionar
Se a integração não funcionar como esperas, verifica estes pontos antes de contactares a equipa de Customer Experience:
Confirma que a conta está aprovada e ativa.
Verifica se não existem validações pendentes com o fornecedor.
Confirma que as credenciais estão corretas e completas.
Garante que estás a usar credenciais de produção.
Verifica se o fornecedor ativou a integração ou o módulo API.
Confirma que a plataforma correta está associada à configuração de pagamentos.
Verifica o estado da transação na Avantio e no painel do fornecedor.
Atualiza a página e volta a verificar o resultado.
Faz uma nova reserva de teste, se necessário.
Se o problema persistir, cria um ticket e inclui:
Nome da Empresa.
Plataforma de pagamento utilizada.
Data e hora aproximadas da operação.
Identificador da reserva.
Valor e moeda.
Estado do pagamento.
Mensagem de erro completa.
Capturas de ecrã.
Confirmação de que o onboarding está concluído.
Não incluas palavras-passe, tokens completos ou outras credenciais sensíveis nas capturas de ecrã.
Perguntas frequentes
Tenho de contratar a plataforma antes de a ligar à Avantio?
Tenho de contratar a plataforma antes de a ligar à Avantio?
Sim. Deves criar ou contratar a conta diretamente com o fornecedor e concluir o processo de onboarding e verificação correspondente.
A Avantio intervém na ligação técnica, mas não substitui o contrato entre a tua Empresa e a plataforma de pagamento.
Quanto tempo demora a ativação?
Quanto tempo demora a ativação?
O prazo depende de cada fornecedor:
A Stripe pode ser ativada no próprio dia se a conta Standard já estiver pronta.
A Comercia Global Payments pode demorar cerca de uma semana.
Tilopay, Ascent e SysPay costumam demorar alguns dias.
O Mercado Pago pode ser ativado imediatamente após receber e configurar as credenciais corretas.
Estes prazos são indicativos e podem variar.
Posso enviar as credenciais por e-mail?
Posso enviar as credenciais por e-mail?
Utiliza sempre o canal seguro indicado pela equipa de Customer Experience.
Não partilhes palavras-passe, tokens ou chaves sensíveis através de canais não autorizados.
É obrigatório fazer uma reserva de teste?
É obrigatório fazer uma reserva de teste?
Sim, é altamente recomendado.
A reserva de teste permite confirmar que a plataforma está ligada, que o pagamento é registado corretamente e que a autenticação funciona antes de processares reservas reais.
Quem configura a ligação?
Quem configura a ligação?
Depende da plataforma.
Em alguns casos, a Avantio fornece um link ou configura as credenciais. Noutros, o fornecedor tem de ativar previamente um módulo ou contactar diretamente a Avantio.
Posso mudar de plataforma de pagamento?
Posso mudar de plataforma de pagamento?
Sim, mas deves primeiro rever os pagamentos pendentes e as reservas existentes.
Não desatives a plataforma anterior sem confirmar como serão geridos os pagamentos que ainda não foram processados.
O que devo fazer se alterar uma credencial?
O que devo fazer se alterar uma credencial?
Contacta a equipa de Customer Experience da Avantio para atualizar a configuração.
Uma credencial alterada ou revogada pode interromper o processamento dos pagamentos.
Posso usar várias plataformas ao mesmo tempo?
Posso usar várias plataformas ao mesmo tempo?
A disponibilidade desta opção depende da configuração da tua conta, da estrutura da tua Empresa e do uso pretendido.
Contacta a equipa de Customer Experience para analisarmos o teu caso.