Transações
Esta é a aba utilizada para realização de transações avulsas e transações recorrentes, bem como efetuar busca por elas e exportá-las para um arquivo .csv que auxilie no seu processo interno de conciliação.
Para realizações de transações no ambiente de teste, segue tabela:
No ambiente de testes não há verificação do cartão de crédito (retornando sempre que forem autorizadas). Você pode gerar números de cartões inexistentes que a API retornará como Autorizada. Para realizar os testes de insucesso, verifique a tabela anterior.
Já para débito em QA, é possível testar o status de transação Iniciada e Autorizada.
a) Transacionando
É bem simples gerar uma cobrança avulsa utilizando o Nix, esteja você criando uma nova cobrança avulsa ou recorrente manualmente por meio do nosso painel de controle. Para que seja possível transacionar, basta acessar a aba Transações e clicar no botão “Criar Cobrança”.
Em seguida, será preciso selecionar a forma de cobrança:
Cobrança Avulsa: é uma captura única de um valor no cartão do cliente.
Cobrança Recorrente: o débito acontece de maneira programada, durante um período de tempo definido e não compromete o limite do cliente.
Para ambos os tipos de cobrança, é possível limitar a forma de pagamento que será disponibilizada ao cliente:
Lembrando que as formas de pagamento devem ser previamente acordadas em contrato.
b) Criando uma Cobrança Avulsa
Após acessar Painel > Criar Cobrança > Cobrança Avulsa, deverão ser preenchidas as seguintes informações:
Campos obrigatórios
Nome: preencher com o nome do cliente
E-mail: e-mail do cliente que irá receber a fatura ou o recibo da transação aprovada
CPF/CNPJ: dados do cliente
Número do pedido: ATENÇÃO, este código não pode se repetir. Aconselhamos a criação de uma chave única que evite a duplicidade.
Valor: valor da transação avulsa que será cobrada
Caso seu plano contemple boletos, preencher também os dados abaixo:
Em seguida, você deverá selecionar de que forma será realizada a transação:
Enviar cobrança por e-mail: o cliente irá receber o compromisso para pagamento por e-mail conforme abaixo. A mensagem de envio deste boleto pode ser customizada pelo estabelecimento.
O e-mail encaminhado para cobrança possui validade de 24 horas. Caso o cliente tente acessar a tela de pagamento após esse prazo, não será possível realizar a ação. Basta gerar uma nova cobrança e encaminhar para o e-mail do cliente novamente.
Pagar agora: aqui é apresentada a tela de pagamento onde o portador do cartão deve inserir seus dados.
Para ambas as opções, o retorno da transação será demonstrado na tela, sendo ela aprovada ou rejeitada. Lembrando que no caso da transação encaminhada via e-mail, você só terá o registro na tela de transações quando seu cliente abrir o checkout e realizar o pagamento.
c) Criando uma Cobrança Recorrente
No painel, acesse Transações > Criar cobrança > Cobrança Recorrente. Serão solicitadas as informações abaixo:
Os pontos mais importantes nessa modalidade são:
Número do pedido: é um número ou texto que identifica a transação como única. Não pode ser repetido.
Plano de Recorrência: selecionar o plano cadastrado no Nix Gateway (vide o tópico a seguir).
Valor do plano: O cliente deve habilitar essa opção caso queira que a transação inicial seja realizada no valor do plano da recorrência. Pode também digitar o valor desejado caso não habilite a flag.
Pré-Autorização (crédito): Transações de pré-autorização também são conhecidas como reserva de limite no cartão de crédito.
Data de início: data do início da recorrência.
Data de encerramento: data do fim da recorrência (Não é um campo obrigatório, visto que a recorrência pode não ter uma data limite estabelecida).
Apenas para recorrências na modalidade crédito :
O estabelecimento pode habilitar o campo acima caso deseje que a transação capturada durante o preenchimento do checkout seja uma pré-autorização, onde este tipo de transação apenas valida o cartão do cliente e ela é, posteriormente, estornada automaticamente. Desta forma, esta transação inicial não irá comprometer a fatura do cliente e a primeira cobrança verdadeira no seu cartão acontecerá na data de início da recorrência.
Etapa de segurança no cartão do cliente (Crédito):
1- Ao realizar a venda, você sinaliza que a transação terá a validação de cartão.
2- Seu cliente receberá um código que vai aparecer na fatura do cartão.
3- O cliente portador do cartão deve validar esse código em até 24h.
4- Caso não seja validado, você pode decidir o que fazer.
Cancelar e interromper a recorrência de transações não validadas: Caso não ocorra validação, é cancelada a recorrência
Obs.: uma transação de pré-autorização necessita, obrigatoriamente, ser de um valor acima de R$ 0,11.
A cobrança pode ir para o e-mail do cliente, ou você pode clicar em “Pagar agora” para inserir os dados manualmente e efetuar a cobrança. Somente após a aprovação da primeira cobrança a nova recorrência será listada na tela de recorrências.
Exemplo:
Assim que o cliente realizar o pagamento com sucesso, caso a data de início da recorrência for o mesmo dia, o valor já será cobrado e a próxima cobrança será programada conforme o plano.
Já se a data de início for futura, a cobrança no cartão do cliente será apenas uma pré-autorização no valor de R$ 0,15 para a validação do cartão, que é automaticamente estornada posteriormente. O valor cheio do plano é cobrado do cliente na data de início da recorrência.
d) Exportação e conciliação de transações
Como forma de melhorar sua experiência e facilitar a conciliação de valores, temos uma opção dentro da nossa ferramenta que permite a extração de relatórios. O recurso dá liberdade e visibilidade para você trabalhar a informação no seu sistema, pois ele oferece todos os dados referentes às transações, como Autorização, NSU, PaymentToken, MerchantOrderID, Status das Transações e dados básicos do cliente vinculados à transação de acordo com o filtro pré-selecionado.
Você pode gerar as transações de cartão ou de boleto compilado em um arquivo .csv. Para gerar o relatório, basta selecionar o filtro desejado e clicar na opção “Exportar dados”. O download do arquivo será efetuado na extensão .csv.
Caso o resultado do filtro supere 5.000 (cinco mil) registros, será demonstrado as opções abaixo:
Caso selecionada a opção “Baixar Relatório” (máximo de 5.000 registros), o download do arquivo de até 5.000 transações será iniciado. Se selecionada a opção “Enviar relatório por e-mail”, o e-mail de destino é solicitado e o documento completo é processado e disparado.
e) Status das transações
Listamos abaixo todos os possíveis status de uma transação com uma breve descrição deles:
0 – Iniciado
– Esse status pode decorrer de transações de Crédito e Débito.
– Nas transações de Débito, pode ocorrer quando não é realizado o challenge para os cartões que o exigem.
– Nas transações de Crédito, o sistema poderá mostrar o status Iniciado quando existe algum problema de comunicação. Nesse caso, existe a possibilidade do cliente escolher a opção de retentativa automática (definido nas configurações do estabelecimento). Quando o sistema fizer a retentativa será seguida a seguinte regra:
Caso exista a transação, o sistema retorna o status da adquirente.
Caso não exista nenhum retorno ou informação, o sistema atualizará o status da transação para “Não finalizado”.
Para transações de recorrência esse processo de retentativa é automático, independe da configuração da loja.
1 – Pré autorizado
– Esse status pode decorrer de transações de Crédito.
– Quando existe a necessidade de realizar uma pré autorização sem descontar do saldo do cartão do cliente, é realizada uma pré captura, e a mesma pode se tornar uma captura quando a transação for confirmada pelo estabelecimento. Caso a pré captura não se torne captura, a mesma é cancelada pela adquirente e o período de cancelamento depende de cada emissor.
2 – Capturado
– Esse status pode decorrer de transações de Crédito e Débito.
– A atualização para esse status ocorre quando a transação é realizada com sucesso.
3 – Cancelado
– Esse status pode decorrer de transações de Crédito e Débito.
– A regra de cancelamento pode variar para cada adquirente, mas existe a possibilidade de realização do cancelamento da transação em dias anteriores ou no dia corrente.
4 – Em Análise
– Esse status não é utilizado pelo sistema atualmente.
5 – Pré Chargeback
– Esse status pode decorrer de transações de Crédito e Débito.
– Ocorre geralmente quando o chargeback é iniciado ou está em andamento.
6 – Chargeback
– Esse status pode decorrer de transações de Crédito e Débito.
– O chargeback ocorre quando existe um aceite do estabelecimento concordando com a contestação feita pelo cliente.
7 – Cartão Inválido
– Esse status pode decorrer de transações de Crédito e Débito.
O status cartão inválido refere-se a validação que implementamos em nossa aplicação .
É uma ferramenta que permite verificar se um cartão está valido para realizar uma compra antes que o pedido seja finalizado. Ele faz isso simulando uma autorização, mas sem afetar o limite de crédito ou alertar o portados do cartão sobre o teste.
Ela não informa o limite ou características do cartão ou portador, mas simula uma autorização , validando dados como:
Se o cartão está valido junto ao banco emissor
Se o cartão possui limite disponível
Se o cartão funciona no Brasil
Se o número do cartão está correto
Se o CVV é valido
8 – Não Finalizado
– Esse status pode decorrer de transações de Crédito e Débito.
– Pode ocorrer após uma transação com o status “Não Iniciado”. Dependendo da regra utilizada pelo estabelecimento poderá ocorrer a retentativa (para a recorrência, independente da regra a retentiva é feita sempre). Nessa retentativa o sistema poderá atualizar o status para Não Finalizado quando não houver informações de retorno desse pagamento perante a adquirente.
9 – Não Autorizado
– Esse status pode decorrer de transações de Crédito e Débito.
– A transação fica definida como “Não Autorizada” quando a mesma é negada pela adquirente.