Perguntas Frequentes

Quais motivos levam um boleto ao status 11 - Não registrado?

R: Alguns motivos podem levar a isto Ausência de dados de endereço e Cep inválido

O que é o status  401 e 403 no retorno da API?

R: Ambos os status referem-se ao Token/Identificação Não Autorizado.  Reveja o seu token.  O parâmetro ‘Authorization’ pode estar com o token expirado, ou o token não possui acesso ao método,  ou ele foi gerado errado.  Para compor o token verifique a documentação no menu:  “Api – Primeiros Passos”.

Ao fazer transações, a API pode demorar para responder enquanto autoriza um transação de cartão?

R: Não demora. A resposta é imediata e vem na resposta da requisição.

Tenho configurado no Nix Gateway a(s) URL(s) de notificação.  Que tipo de informação vou receber nessas URLs? Será enviado um “GET” nas URLs?

R: É enviado um “POST” com o corpo definido (Response Class) na documentação de cada método. Por exemplo, se ocorreu uma transação de cartão de crédito, será enviado um post com corpo igual ao de resposta do método de /Orders/CardPayments/Authorize.

Qual é a versão do UUID utilizada pelo Nix Gateway?

R: Utilizamos a versão standard que segue as definições da RFC 4122.

No método de autorização de cartões, por que devo enviar a bandeira (parâmetro brand) ?

R: Não precisa enviar. Se você não enviar, nós tentaremos “adivinhar” qual a bandeira pelo número do cartão conforme nossos algoritmos.

No método de autorização de cartões, o que acontece se eu enviar uma bandeira que não corresponde a bandeira do meu cartão? 

R: Se você enviar uma bandeira que não corresponde a bandeira do seu cartão, nós repassaremos a informação para a adquirente ficando a critério dela autorizar ou rejeitar. Há casos que a transação foi aceita porque a adquirente conseguiu identificar e corrigir a bandeira correta.

Nós exibimos no backoffice e nos retornos das transações a bandeira que você nos enviou.

Checkout:

Quais os browsers suportados no checkout Nix ?

R: Caso você utilize este checkout construído pelo time Nix, ele não é suportado no Internet Explorer e pode haver diferença na disponibilização dos elementos entre os browsers. Lembre que você também pode construir seu próprio checkout (checkout transparente) usando as APIs para transacionar.

Débito:

O que é o challenge?

Challenge é a chamada do emissor para a autenticação do usuário por meio de informações pessoais de cadastro e código token.

É possível enviar uma recorrência para transações de débito?

R: Não trabalhamos com recorrência para cartão de débito visto que é necessário a interação humana, através do challenge, que pode ocorrer  para que o cliente valide seus dados.

No método do débito automático é enviado uma URL no returnUrl, que é usada pela adquirente para redirecionamento após o sucesso do challenge. Essa URL é sempre chamada? Tanto em caso de falha quanto em caso de sucesso?

R: Ela é sempre chamada tanto em casa de falha quanto em caso de sucesso. Somente não se o débito ocorrer direto sem challenge (situação atípica).

Como que o NIX Gateway sabe que o débito ocorreu com sucesso? O Banco notifica?

R:  Deve ser feito a chamada no método verifyPayment, nesse momento é que é consultado o status do pagamento. O banco não nos notifica.

Notificações webhook / callbacks:

Recebi a informação que posso configurar URLs de notificação/callback. Que URLs são essas?

R: São 3 URLs que enviamos notificações de método POST referente aos status de transações e suas mudanças.

Cartões: URL para notificação de mudança de status
Boletos:  URL para notificação de mudança de status
Recorrência:  URL para notificação de alterações de recorrências

O que é notificado em cada URLs de notificação/callback?

• Url de cartões:

No endpoint de pagamento, o retorno da api é síncrono. Também é enviado de forma assincrona para a url configurada. Serão enviadas notificações de todas as transações que sofreram alterações no nosso sistema. Por exemplo, ao realizar uma transação de crédito, você receberá a resposta imediata da autorização (ou não-autorização), e receberá também na sua url.

Esse também é o comportamento para as recorrências de cartão de crédito.  Quando a transação de cartão é lançada automaticamente pela Nix, você receberá a resposta imediata da autorização (ou não-autorização) na url configurada.

As notificações tem a mesma estrutura de retorno que damos no método de autorização de cartão. Ver o retorno em: https://web-nix.nexxera.io/index.php/api/cardpayments/

• Url de boletos:

No endpoint de boletos, o retorno da api é síncrono. Também é enviado de forma assincrona para a url configurada. Serão enviadas notificações dos boletos que sofreram alterações no nosso sistema. (ex. Criação do boleto e pagamento)

A notificação tem a mesma estrutura de retorno que damos na criação do boleto. Ver: https://web-nix.nexxera.io/index.php/criando-um-boleto/

• Url de recorrências:

No endpoint de recorrências, o retorno da api é síncrono. Também é enviado de forma assincrona para a url configurada. Serão enviadas notificações das recorrências que sofreram alterações no nosso sistema (exs. cancelamento, Reativação, alterações de data de término, forma de pagamento).

Na url das recorrências, os mesmos retornos que a API fornece de forma síncrona, é enviado de forma assíncrona para a url configurada.  Por exemplo, ao ser cancelada uma recorrência, você receberá a resposta imediata da api, e receberá também na url configurada .

A notificação tem a mesma estrutura de retorno que damos na consulta de recorrência pelo número do pedido. Ver: https://web-nix.nexxera.io/index.php/consultando-as-recorrencias-pelo-no-do-pedido/

 PIX:

Como habilitar para recebimento PIX?
É necessário sinalizar ao time de suporte atendimento@minhanix.com.br indicando a necessidade de recebimento via PIX. Esta informação pode ser repassada no momento da implantação ou a qualquer momento em que seja necessário habilitar esta funcionalidade.