Perguntas Frequentes

Começando

Como faço para obter uma conta Staging?

Se você estiver em contato com qualquer um de nossos representantes comerciais (BizDev), pode pedir que ele te forneça acesso ao nosso Dashboard EBANX em Staging (ambiente de teste). Caso contrário, envie um e-mail para inside-sales@ebanxpay.com.

Como obtenho as chaves de integração?

Depois de configurar sua conta, você deverá entrar em contato com nossos representantes comerciais no e-mail inside-sales@ebanxpay.com.

Como começo a usar o EBANX?

Você pode conectar seu comercio a uma conta EBANX e aumentar suas vendas, oferecendo diversos métodos de pagamento. Para saber mais, clique aqui.

Quais métodos de pagamento posso aceitar através do EBANX?

Uma vez integrada ao EBANX, sua empresa pode oferecer pagamentos com os principais métodos.

Veja a lista completa dos nossos produtos aqui.

Going Live

Qual é a diferença entre a chave de integração e a chave de integração pública?

A chave de integração é usada para fazer solicitações às nossas operações de API. Mantenha segura e não exponha essas informações.

A chave de integração pública é usada para fazer operações de token do client (navegador, aplicativo, etc.) de seu cliente. Ao fazer isso, você não precisa lidar diretamente com as informações confidenciais do cartão de crédito.

Estou tendo problemas com minha chave de integração, como por exemplo, erro de chave de integração inválida. O que eu posso fazer?

Verifique se você está usando a chave de integração certa no ambiente certo. Um erro comum é usar uma chave de integração de teste no ambiente de produção e vice-versa. Se o erro persistir, entre em contato com nossos especialistas de integração.

Acabei de receber minhas chaves de integração in live. O que eu deveria fazer agora?

Primeiro, você deve substituir sua chave de integração de teste antiga pela nova chave “ativa” (chave de produção), assim todos os pagamentos serão redirecionados para sua conta ativa em produção. Além disso, pode ser necessário desligar o modo de teste em seu aplicativo.

Quando eu receber minhas credenciais live, perderei minhas credenciais do ambiente staging?

Suas credenciais do ambiente staging não serão excluídas. Você ainda pode usá-las se quiser executar alguns testes. Além disso, se estiver planejando ativar novos recursos, você precisará usar sua conta do staging para testá-los.

Terminei meus testes, posso entrar em produção?

Ainda não! Depois de concluir seus testes, entre em contato conosco através de inside-sales@ebanxpay.com e nós faremos alguns testes para verificar se sua integração está funcionando corretamente (não se preocupe, essas solicitações geralmente são tratadas muito rapidamente!). Depois disso, criaremos sua conta de produção e enviaremos suas credenciais.

Quando posso obter minhas chaves de produção?

Depois de preparar toda a integração, informe-nos através de inside-sales@ebanxpay.com para que possamos fazer alguns testes e enviar suas chaves ativas o mais rápido possível.

Criei usuários adicionais no Dashboard EBANX para minha conta staging. Esses usuários estão disponíveis na nova conta ativa?

Não. A conta in live não usa nenhum dos usuários criados no ambiente de teste. Se precisar deles, você deverá criá-los novamente, ok?

Pagamentos

Quais são os códigos de resposta do EBANX devolvidos ao estabelecimento comercial em caso de falha no pagamento?

Após a rejeição do pagamento com cartão de crédito, a API EBANX pode retornar 2 tipos de erros para o merchant: Soft declined e Hard declined. Essas mensagens/códigos geralmente são retornados logo após a rejeição do pagamento. Você poderá consulta-lo para obter mais detalhes.

1 – Soft declined: É executado por um processador de cartão de crédito quando o banco emissor recusa a transação porque algo deu errado no processo de autorização, por exemplo, fundo insuficiente. Você pode obter mais detalhes sobre nossas respostas aqui.

2 – Hard declined: Regras de negócios, predefinidas, do EBANX que podem recusar uma transação, por exemplo, o valor do pagamento excedeu o montate máximo permitido para esse tipo de pagamento específico. Você pode obter mais detalhes sobre nossos códigos de erro aqui.

Estou recebendo uma mensagem de erro dizendo que o tipo de pagamento não está habilitado para um merchant

Se esse erro acontecer em sua conta do staging, você pode entrar em contato conosco em local-integrations@ebanxpay.com informando-nos seu nome de merchant e o problema será resolvido rapidamente. Se você estiver em sua conta de produção, certifique-se de que a forma de pagamento que está tentando usar está incluída no contrato que você assinou, caso contrário você pode entrar em contato com nossos representantes comerciais para resolver isso.

Um dos meus clientes tentou fazer um pagamento e recebeu o erro “BP-DR-98 - O país do cliente não corresponde.”

O que aconteceu foi que o seu cliente provavelmente tem um e-mail cadastrado em outro país. Para resolver isso, o país do pagamento precisa ser igual ao país de residência do seu cliente.

Qual é a diferença entre payment.order_number e merchant_payment_code?

O merchant_payment_code é um identificador exclusivo de seu pagamento em nosso sistema; nosso sistema não gerará novos pagamentos com um merchant_payment_code que já exista em sua conta, por tanto você deverá informar um novo código a cada requisição. O payment.order_number é o número de um pedido em seu sistema e não poderá ser utilizado como um identificador para criar pagamentos com o mesmo número do pedido. Você pode usar este campo para identificar um grupo de pagamentos, como novas tentativas de um cliente no mesmo checkout.

Posso desabilitar os emails que EBANX envia aos meus clientes?

Infelizmente você não pode. Os e-mails que o EBANX envia aos clientes contêm informações importantes sobre seus pagamentos que precisam ser enviados por questões de conformidade e legais.

Métodos de Pagamento

Estou recebendo uma mensagem de erro dizendo que o tipo de pagamento não está habilitado para um merchant. Porque?

Se esse erro acontecer em sua conta do staging, você pode entrar em contato conosco em local-integrations@ebanxpay.com informando-nos seu nome de merchant e o problema será resolvido rapidamente. Se você estiver em sua conta de produção, certifique-se de que a forma de pagamento que está tentando usar está incluída no contrato que você assinou. Você pode entrar em contato com nossos representantes comerciais para obter essas informações.

Pagamentos com cartão de crédito

Eu preciso de um certificado SSL?

Ter um certificado SSL para sua página de checkout diminui as chances de seus clientes desistirem de suas compras, já que isso faz com que os clientes se sintam seguros ao inserir suas informações de pagamento. Se você for processar pagamentos com cartão de crédito usando a integração com EBANX Direct API, o SSL é obrigatório. Se o seu site não tiver um certificado SSL, você pode usar a Payment Page EBANX.

Preciso manter as informações do cartão do cliente?

Não, caso você esteja utilizando a tokenização, nós recuperaremos as informações do cartão de crédito do cliente com base no token enviado na requisição. É altamente recomendável enviar o token + CVV, pois isso pode melhorar suas taxas de aprovação.

Pagamentos recorrentes

Os pagamentos recorrentes funcionam automaticamente?

Não, cada vez que você deseja cobrar do seu cliente, será necessário fazer uma nova solicitação. Caso queria mais detalhes sobre pagamentos recorrentes, veja nossa documentação sobre como criar pagamentos recorrentes AQUI.

Por quanto tempo é válido o token para o pagamento recorrente?

Os tokens expiram 14 meses após o último uso.

Para pagamentos recorrentes, os períodos podem ser definidos como semanais/mensais/anuais?

Você pode escolher o perfil recorrente que funciona melhor para o seu negócio: Semanal/Mensal/Anual/Diário. Você só precisa fazer uma solicitação usando o token que você gerou sempre que quiser cobrar de seu cliente e controlar quando quer fazer isso. Lembre-se de comunicar ao seu cliente sobre essas cobranças.

Se os pagamentos recorrentes não forem cobrados do cartão do cliente por qualquer motivo (como cartão vencido, fundos insuficientes ou data de vencimento incorreta), como posso obter informações sobre essas transações com falha usando uma API para que eu possa interromper a assinatura de um cliente e notificá-los sobre a situação ?

Se a transação não for concluída, especificaremos o motivo da falha em nossa resposta à solicitação. Usamos os seguintes códigos de status de transação:

OK: O valor da transação foi aprovado.

NOK: O adquirente não aprovou a transação. O cliente deve entrar em contato com o emissor para verificar se há algum problema com o cartão de crédito.

RETRY: Algo deu errado com o processo. Você pode tentar novamente com os mesmos dados. Recomendamos que você tente mais 3 vezes com um intervalo de 2 horas entre cada tentativa.

Você pode ver mais sobre esses status AQUI.

Como posso cancelar os pagamentos recorrentes de um cliente depois de configurados?

Se você não vai mais cobrar de um cliente, não precisa desativar os pagamentos recorrentes, basta interromper as requisições com esse token.

Manipulação de Notificação

O que são as notificações e como funcionam?

Quando um status de pagamento é alterado o EBANX envia uma notificação ao seu sistema através de uma URL de notificação. Seu sistema receberá a notificação e, em seguida, deverá chamar a Query Operation. Ao fazer isso, você terá o status e mais informações sobre esse pagamento.

Depois de receber a notificação, você deve gerar uma resposta (pode ser qualquer string de sua preferência) indicando que a notificação foi bem sucedida. Poderá, também, verificar suas notificações em Transações Digitais no seu Dashboard.

As notificações são importantes, pois indicam quando você pode entregar seu produto/serviço ao cliente.

Para informações mais detalhadas e técnicas, verifique nossa documentação aqui.

E quanto à minha URL de notificação?

Depois de ter sua conta in Live, é muito importante configurar sua URL e receber todas as notificações do EBANX.

Não se esqueça de configurar sua URL, alguns merchants têm problemas ao mudar para o ambiente in Live porque se esqueceram de definir suas URLs para a nova conta.

Ao fazer esta configuração, certifique-se de que está usando a URL correta e não a do seu ambiente de teste. Além disso, certifique-se de usar https em vez de HTTP. Como você altera esta configuração? AQUI está um link para nossa documentação que trata disso.