Configura a tua gateway de pagamento
A Avantio permite ligar diferentes gateways de pagamento para automatizar as cobranças associadas às reservas.
O processo de integração depende de cada fornecedor. Algumas plataformas exigem configurações específicas por parte do teu banco, enquanto outras necessitam de credenciais de produção, tokenização, webhooks ou de um site operacional para concluir os testes.
Antes de iniciares o processo técnico, deves confirmar a compatibilidade, formalizar o contrato correspondente e concluir o onboarding solicitado pelo fornecedor.
O que vais aprender neste artigo?
Neste artigo vais aprender a:
Preparar a informação necessária antes de iniciares a ligação.
Solicitar as ativações necessárias ao teu banco ou fornecedor.
Identificar as credenciais necessárias para cada plataforma.
Configurar webhooks e tokenizações.
Concluir a ligação com o apoio da Avantio.
Realizar os testes necessários antes de processar pagamentos reais.
Resolver os erros mais comuns durante a integração.
Vantagens
Ligar uma gateway de pagamento à Avantio permite-te:
Automatizar as cobranças das reservas.
Reduzir as operações manuais.
Aplicar sistemas de autenticação como o 3D Secure.
Centralizar a configuração dos pagamentos.
Melhorar a rastreabilidade das transações.
Realizar pré-autorizações quando a plataforma o permitir.
Processar pagamentos posteriores conforme a configuração contratada.
Receber notificações de pagamento em tempo real.
Facilitar a gestão de reembolsos e incidentes.
Quando deves fazer esta configuração?
Deves iniciar esta configuração quando:
Já escolheste a plataforma de pagamento.
Confirmaste que opera no teu país.
Conheces os custos associados.
O fornecedor aprovou a conta da tua empresa.
Tens as credenciais de produção.
O teu banco realizou as ativações necessárias.
Queres substituir uma ligação anterior.
Precisas de automatizar as cobranças a partir da Avantio.
Antes de começar
Convém rever previamente:
Que a empresa está registada num país compatível.
Que já formalizaste o contrato com o fornecedor.
Que o processo de onboarding está concluído.
Que tens acesso administrativo à conta.
Que as credenciais correspondem ao ambiente de produção.
Que o teu TPA é compatível com os protocolos exigidos.
Que tens um site operacional quando necessário.
Que já definiste quem vai gerir os testes.
Que conheces os métodos de pagamento que vais utilizar.
Que já confirmaste se precisas de pré-autorizações ou tokenização.
Também é recomendável coordenar a ativação com a equipa responsável pelas reservas, pagamentos e conciliação.
Nunca partilhes credenciais sensíveis através de canais não autorizados. Fornece a informação solicitada através de um ticket dirigido à equipa de Customer Experience.
Liga a tua plataforma escolhida à Avantio
Redsys através da Worldline
Redsys através da Worldline
A integração permite ligar um TPA Redsys à Avantio Payments utilizando o conector fornecido pela Worldline.
Antes de começar
Contacta a equipa de Customer Experience da Avantio para verificar se o teu banco e o teu TPA são compatíveis.
Atualmente, esta integração não está disponível com o Banco Sabadell.
Depois de confirmada a compatibilidade, a Avantio irá fornecer-te o contrato correspondente.
Solicita as ativações ao teu banco
Após assinares o contrato, pede ao teu banco as seguintes configurações:
Ativação do protocolo SIS REST PSPS.
Associação do comércio Redsys a PSP OGONE SIS REST COM MPI EXTERNO.
Ativação das operações MIT.
Ativação das operações MOTO.
Habilitação do 3D Secure v2.
Ativação das pré-autorizações.
As operações MOTO são necessárias para determinadas transações relacionadas com portais.
As pré-autorizações permitem fazer retenções e libertações de montantes, por exemplo, para gerir cauções.
Configuração adicional para o BBVA
Quando o banco adquirente for o BBVA, deves também pedir a ativação do protocolo de CVC opcional.
Se o teu banco precisar de informação técnica adicional, pode contactar a Avantio através de:
Dados necessários
Assim que o banco confirmar as ativações, cria um ticket para a equipa de Customer Experience e fornece:
Merchant ID ou FUC.
Código MCC ou categoria do comércio.
Número de terminal.
Métodos de pagamento disponíveis.
Acquirer BIN da Visa.
Acquirer BIN da Mastercard.
Indica também se o TPA aceita outros métodos, como American Express.
Segue estes passos
Contacta a equipa de Customer Experience da Avantio.
Pede a verificação de compatibilidade do teu banco.
Confirma que o teu banco pode trabalhar com o protocolo exigido.
Revê e assina o contrato fornecido pela Avantio.
Pede ao banco a ativação do protocolo SIS REST PSPS.
Pede a associação do comércio a PSP OGONE SIS REST COM MPI EXTERNO.
Solicita a ativação de MIT e MOTO.
Pede a habilitação do 3D Secure v2.
Solicita a ativação das pré-autorizações se vais gerir cauções.
Se trabalhas com o BBVA, pede o CVC opcional.
Aguarda que o banco confirme todas as ativações.
Reúne o Merchant ID, MCC, número de terminal e Acquirer BIN.
Fornece os dados à Avantio através de um ticket.
Aguarda que a configuração técnica seja concluída.
Faz uma reserva de teste.
Verifica o funcionamento do pagamento.
Testa as operações posteriores ou as pré-autorizações quando aplicável.
Tempo estimado de ativação
O processo pode demorar desde alguns dias até várias semanas.
O prazo depende de:
A rapidez de resposta do banco.
A configuração prévia do TPA.
A ativação do protocolo necessário.
A validação dos identificadores técnicos.
A ativação final da plataforma.
Axerve
Axerve
Antes de começar
Contacta a Axerve para formalizar o contrato e pedir a abertura da conta.
Quando contactares o fornecedor, pede também o serviço de Tokenization se precisares de utilizar cartões tokenizados para pagamentos posteriores.
Depois de aprovado o contrato, a Axerve irá dar-te acesso à sua intranet ou backoffice.
Credenciais necessárias
No painel da Axerve deves obter:
ShopLogin.
ApiKey.
Além disso, terás de configurar uma URL de webhook para receber as notificações de pagamento.
Configura o webhook
O webhook permite que a Axerve comunique à Avantio as alterações de estado das transações em tempo real.
Pede a URL à Avantio
Cria um ticket para a equipa de Customer Experience.
Indica que estás a configurar a Axerve.
Pede a URL de webhook correspondente à tua conta.
Guarda a URL exatamente como te for fornecida.
Adiciona a URL na Axerve
Acede ao painel da Axerve.
Vai a Configurazione.
Seleciona Ambiente.
Procura o campo Url server to server.
Copia a URL fornecida pela Avantio.
Guarda a configuração.
Não alteres a URL nem adiciones espaços extra.
Segue estes passos
Contacta a Axerve.
Indica que vais usar a integração com a Avantio.
Formaliza o contrato.
Pede o serviço de tokenização quando necessário.
Conclui as verificações da conta.
Acede ao backoffice da Axerve.
Procura o ShopLogin.
Obtém a ApiKey.
Cria um ticket para a equipa de Customer Experience.
Pede a URL do webhook.
Acede a Configurazione → Ambiente → Url server to server.
Introduz a URL fornecida.
Guarda a configuração.
Fornece à Avantio o ShopLogin e a ApiKey.
Aguarda que a integração seja concluída.
Faz uma reserva de teste.
Verifica que a Axerve envia as notificações de pagamento.
Confirma que o estado da transação é atualizado na Avantio.
Tempo estimado de ativação
A ligação pode ser concluída no próprio dia em que a Avantio recebe e valida os dados fornecidos pela Axerve.
O prazo pode aumentar quando:
O contrato ainda não está aprovado.
A tokenização não está ativa.
As credenciais estão incorretas.
O webhook não está configurado.
A conta não está habilitada para operar em produção.
Amazon Payment Services
Amazon Payment Services
Antes de começar
Contacta a Amazon Payment Services para formalizar o contrato e iniciar o processo de onboarding.
Durante este processo, indica expressamente que precisas de utilizar a tokenização.
A tokenização é necessária para guardar de forma segura uma referência do cartão e realizar as operações permitidas pela plataforma sem guardar diretamente os dados sensíveis.
Credenciais necessárias
Para ativar a ligação precisas de:
MerchantId.
AccessCode.
ShaRequest.
ShaResponse.
As credenciais devem corresponder ao ambiente de produção, exceto se forem pedidos dados específicos para testes.
Segue estes passos
Contacta a Amazon Payment Services.
Confirma que a plataforma está disponível no teu país.
Indica que vais usar a integração com a Avantio.
Formaliza o contrato.
Completa a documentação do onboarding.
Pede a ativação da tokenização.
Aguarda que a Amazon Payment Services aprove a conta.
Solicita as credenciais de integração.
Confirma que tens o MerchantId, AccessCode, ShaRequest e ShaResponse.
Cria um ticket para a equipa de Customer Experience da Avantio.
Envia as credenciais pelo canal seguro indicado.
Aguarda que a Avantio conclua a configuração.
Faz uma reserva de teste.
Completa a autenticação 3D Secure.
Verifica que a transação aparece corretamente.
Confirma o funcionamento da tokenização quando necessário.
Atenção aos detalhes
Todos os pagamentos processados por esta gateway vão usar 3D Secure por defeito.
Verifica que o fluxo de reserva permite ao hóspede completar corretamente a autenticação.
Tempo estimado de ativação
A ativação costuma demorar alguns dias.
O prazo depende principalmente da conclusão do onboarding, da ativação da tokenização e da entrega das credenciais.
PowerTranz
PowerTranz
PowerTranz é a versão do FAC compatível com 3D Secure v2.
Substitui a integração anterior do FAC, que só permitia 3D Secure v1.
Antes de começar
Para concluir a integração deves ter um site operacional.
O site será usado para fazer testes:
No ambiente de testes.
No ambiente real ou de produção.
Confirma com a PowerTranz que a tua conta e o teu mercado são compatíveis com a versão que suporta 3D Secure v2.
Credenciais necessárias
Solicita à PowerTranz:
PowerTranzId.
PowerTranzPassword.
As credenciais devem corresponder ao ambiente indicado para cada fase dos testes.
Segue estes passos
Contacta a PowerTranz para iniciar o processo de onboarding.
Indica que vais usar a integração com a Avantio.
Confirma que vais contratar a versão compatível com 3D Secure v2.
Fornece à PowerTranz a documentação necessária.
Prepara um site operacional.
Solicita as credenciais do ambiente de testes.
Obtém o PowerTranzId e o PowerTranzPassword.
Cria um ticket para a equipa de Customer Experience da Avantio.
Envia as credenciais pelo canal seguro indicado.
Coordena com a Avantio os testes no ambiente de testes.
Verifica que o processo de autenticação funciona corretamente.
Conclui com a PowerTranz a ativação do ambiente de produção.
Fornece as credenciais finais quando forem diferentes.
Faz um teste no ambiente real.
Verifica que o pagamento aparece tanto na Avantio como na PowerTranz.
Confirma com a Avantio que a integração pode começar a ser usada.
Resultado esperado
No final do processo:
A PowerTranz estará ligada à Avantio.
Os pagamentos vão usar 3D Secure v2.
Poderás processar cartões nas moedas suportadas.
As transações vão aparecer no painel do fornecedor.
O site estará preparado para completar o fluxo de autenticação.
Resultado esperado
Ao concluir a ligação da plataforma selecionada:
A gateway estará ligada à Avantio.
Poderás processar os pagamentos das reservas.
Os pagamentos vão usar a autenticação disponível.
As transações serão enviadas para o fornecedor correspondente.
As alterações de estado serão atualizadas pelo mecanismo configurado.
Poderás realizar as operações permitidas pelo teu contrato.
Os pagamentos posteriores ou pré-autorizações vão funcionar quando estiverem ativos.
Não deves considerar a integração concluída até teres feito corretamente uma reserva de teste.
Próximos passos recomendados
Depois de ativares a plataforma:
Faz uma reserva de teste com um valor reduzido.
Verifica que o pagamento aparece na Avantio.
Confirma que a operação aparece no painel do fornecedor.
Confirma que o valor e a moeda estão corretos.
Verifica o funcionamento do 3D Secure.
Verifica as notificações do webhook quando aplicável.
Testa a tokenização se a contrataste.
Revê os pagamentos posteriores.
Testa uma pré-autorização quando a plataforma permitir.
Verifica o procedimento de devolução.
Confirma as permissões dos utilizadores internos.
Documenta o procedimento para gerir incidentes.
Informa a tua equipa antes de começares a processar pagamentos reais.
Principais dados e opções
Consoante a plataforma, vais precisar de:
Redsys via Worldline: Merchant ID ou FUC, MCC, número de terminal, métodos de pagamento e Acquirer BIN.
PowerTranz: PowerTranzId e PowerTranzPassword.
Amazon Payment Services: MerchantId, AccessCode, ShaRequest e ShaResponse.
Axerve: ShopLogin, ApiKey e URL do webhook.
Também podes precisar de:
Ativação de MIT.
Ativação de MOTO.
Configuração do 3D Secure v2.
Ativação de pré-autorizações.
Tokenização.
Site operacional.
Credenciais de teste e produção.
Configuração server-to-server.
Limitações e considerações
Tem em conta que:
A integração não pode ser concluída até que o fornecedor aprove a conta.
Os prazos dependem do fornecedor ou do banco.
As credenciais devem corresponder ao ambiente correto.
Dados incorretos podem impedir a ligação.
A ativação do 3D Secure depende da configuração da conta.
A tokenização deve ser contratada quando necessária.
As operações MIT e MOTO requerem autorização específica.
As pré-autorizações não estão disponíveis se o banco não as ativar.
Os webhooks devem ser configurados exatamente com a URL fornecida.
A PowerTranz exige um site operacional para realizar os testes.
A Redsys precisa de configurações específicas por parte do banco.
A Amazon Payment Services usa 3D Secure por defeito.
Não deves processar pagamentos reais antes de concluir os testes.
A alteração de uma credencial pode interromper os pagamentos.
Antes de substituíres uma gateway existente, revê o que vai acontecer aos pagamentos pendentes das reservas já criadas.
Boas práticas
Confirma a compatibilidade antes de iniciares o processo.
Utiliza sempre uma conta empresarial.
Conclui o onboarding antes de pedires a ligação.
Solicita credenciais de produção.
Não partilhes palavras-passe ou chaves em canais não autorizados.
Copia as credenciais sem espaços extra.
Guarda as chaves num gestor seguro.
Limita os acessos administrativos.
Ativa a autenticação em dois passos quando disponível.
Configura corretamente o 3D Secure v2.
Pede a tokenização desde o início se vais precisar dela.
Faz testes em todos os ambientes necessários.
Verifica os webhooks depois da ativação.
Confirma tanto os pagamentos iniciais como os posteriores.
Documenta as alterações feitas pelo teu banco.
Não desatives a ligação anterior até validares a nova.
Caso prático
Uma empresa espanhola quer manter as condições do seu TPA Redsys e automatizar os seus pagamentos através da Avantio Payments.
Primeiro, contacta a Avantio para confirmar que o seu banco é compatível.
Depois de assinar o contrato, pede ao banco a ativação do protocolo SIS REST PSPS, MIT, MOTO, 3D Secure v2 e pré-autorizações.
Quando o banco confirma a configuração, a empresa fornece à Avantio o Merchant ID, o MCC, o número de terminal e os Acquirer BIN.
A Avantio conclui a configuração e a empresa faz uma reserva de teste. Também verifica uma pré-autorização para garantir que pode reter e libertar corretamente um depósito.
Depois de verificar todas as operações, começa a usar a ligação com reservas reais.
Erros frequentes
O banco não reconhece o protocolo solicitado
Fornece ao banco o nome completo do protocolo e as operações que devem ser ativadas.
Quando necessário, o banco pode contactar a Avantio através do [email protected].
O Redsys não processa pagamentos posteriores
Verifica se as operações MIT estão ativas.
Confirma também a configuração MOTO quando as transações estiverem relacionadas com determinados portais.
A pré-autorização não funciona
Confirma junto do banco se as pré-autorizações estão ativas no terminal correspondente.
A ativação geral do TPA não garante necessariamente que esta operação esteja disponível.
O pagamento não completa o 3D Secure
Verifica se o 3D Secure v2 está ativo na conta e se o fornecedor configurou corretamente a autenticação.
O PowerTranz não consegue concluir os testes
Confirma se o site está operacional e acessível.
Verifica também se estás a usar a versão do PowerTranz compatível com o 3D Secure v2.
As credenciais do PowerTranz não funcionam
Confirma se as credenciais correspondem ao ambiente de testes ou ao ambiente real.
Não utilizes credenciais de teste para processar pagamentos em produção.
O Amazon Payment Services rejeita a ligação
Verifica se o MerchantId, AccessCode, ShaRequest e ShaResponse estão completos e pertencem à mesma conta.
Confirma também se o onboarding está concluído.
Não é possível processar pagamentos posteriores com o Amazon Payment Services
Confirma se a tokenização está ativa.
Ter contratado a gateway não significa necessariamente que o serviço de tokenização esteja ativo.
O Axerve não atualiza o estado dos pagamentos
Verifica a configuração do webhook.
O URL deve ser adicionado em:
Configuração → Ambiente → Url server to server
A ApiKey do Axerve não é válida
Confirma se a chave é de produção e se não contém espaços ou caracteres adicionais.
A reserva de teste funciona, mas o pagamento real não
Confirma se o teste não foi feito apenas num ambiente de testes.
Verifica se a conta e as credenciais de produção estão ativas.
Se algo não funcionar
Antes de contactares a equipa de Customer Experience:
Confirma se o contrato está formalizado.
Verifica se o onboarding está concluído.
Confirma se a conta está aprovada.
Verifica se as credenciais estão corretas.
Confirma se pertencem ao ambiente de testes ou de produção.
Verifica se o 3D Secure v2 está ativo.
Confirma se a tokenização está ativa quando necessário.
Verifica as configurações feitas pelo banco.
Confirma o URL do webhook.
Confirma se o site está operacional.
Verifica o estado da transação no painel do fornecedor.
Atualiza a página e volta a verificar o resultado.
Faz uma nova reserva de teste.
Se o problema persistir, cria um ticket e inclui:
Nome da empresa.
Plataforma utilizada.
Banco ou adquirente, se aplicável.
Identificador da reserva.
Data e hora da operação.
Valor e moeda.
Estado da transação.
Mensagem de erro completa.
Capturas de ecrã.
Ambiente onde ocorreu o erro.
Confirmação das ativações realizadas.
Não incluas palavras-passe, ApiKeys completas ou outras credenciais sensíveis nas capturas de ecrã.
Perguntas frequentes
Tenho de contratar a plataforma antes de a ligar?
Tenho de contratar a plataforma antes de a ligar?
Sim. Deves formalizar o contrato e concluir o onboarding diretamente com o banco ou fornecedor.
A Avantio intervém na integração técnica, mas não substitui o contrato comercial.
Quanto tempo demora a ativação?
Quanto tempo demora a ativação?
Depende da plataforma:
O Redsys via Worldline pode demorar dias ou semanas.
O PowerTranz pode exigir vários dias e diferentes fases de teste.
O Amazon Payment Services costuma demorar vários dias.
O Axerve pode ser ativado no próprio dia após receber os dados corretos.
Os prazos são indicativos.
O que é a tokenização?
O que é a tokenização?
A tokenização substitui os dados de um cartão por uma referência segura.
Permite realizar determinadas operações posteriores sem armazenar diretamente a informação sensível do cartão.
O que é um webhook?
O que é um webhook?
Um webhook é um URL que permite à plataforma enviar notificações automáticas à Avantio quando o estado de um pagamento muda.
No Axerve, deve ser configurado na secção Url server to server.
Qual a diferença entre MIT e MOTO?
Qual a diferença entre MIT e MOTO?
MIT são transações iniciadas pelo comerciante sobre um cartão previamente autorizado.
MOTO é utilizado para certas operações em que o pagamento é iniciado por canais como email ou telefone. Nesta integração, pode ser necessário para processar algumas transações provenientes de portais.
Para que servem as pré-autorizações?
Para que servem as pré-autorizações?
Permitem reter temporariamente um valor sem efetuar a cobrança definitiva.
Podem ser usadas, por exemplo, para gerir cauções e libertar posteriormente o valor retido.
É obrigatório fazer uma reserva de teste?
É obrigatório fazer uma reserva de teste?
Sim, é altamente recomendado.
A reserva de teste permite verificar o pagamento, a autenticação, as notificações e as operações posteriores antes de trabalhar com reservas reais.
Posso enviar as credenciais por email?
Posso enviar as credenciais por email?
Utiliza apenas o canal seguro indicado pela equipa de Customer Experience.
Não envies palavras-passe nem chaves sensíveis por canais não autorizados.
Quem me pode ajudar durante a ligação?
Quem me pode ajudar durante a ligação?
Podes contactar o teu Account Manager ou a equipa de Customer Experience da Avantio.
Podemos ajudar-te através de um ticket de suporte ou, quando necessário, por videochamada.