Esta rota tem como objetivo realizar a autorização ou pré-autorização e captura de uma venda através de um canal Web utilizando os dados do cartão de crédito - i.e. Websites, E-Commerces, entre outros.
INFO
Obs.: Nenhum dado sensível enviado (dados do cartão de crédito) na requisição será salvo no banco de dados do Gateway para manter a conformidade com a LGPD!
Além disso, essa venda será considerada como uma venda não-presencial, ou seja, haverá um risco maior de ocorrer chargeback.
Observação importante
Para um bom funcionamento e assertividade nas análises de fraude, recomendamos as implementações dos scripts client-side descritos em nossa documentação, que podem ser encontrados clicando aqui.
Respostas das requisições
| Variável | Tipo | Descrição |
|---|---|---|
| createdAt | String | Data de criação da transação |
| status | String | Status da transação |
| localCode | String | Código único interno do sistema para identificar uma transação |
| authorizationCode | String | Código de autorização da transação |
| nsuCode | String | Código complementar ao de autorização da transação |
| gatewayIdentifier | String | Identificador no gateway da transação |
| gatewayOrder | String | Identificador do pedido no gateway da transação |
| valueCents | BigInteger | Valor da transação em centavos |
| installments | Int | Quantidade de parcelas |
| acquirerMessage | String | Resposta da transação pela adquirente |
Como faço para aprovar minhas vendas no ambiente de teste?
Utilizamos o número do cartão de crédito como identidade para autorizar uma venda realizada no ambiente de teste, ou seja, se você usar qualquer um dos cartões abaixo em sua requisição, a venda será Não Autorizada / Negada.
Dados do cartão Bandeira Retorno esperado N: 4929291898380766
CVV: 123 | EXP: 12/2026Visa Negado. N: 5530062640663264
CVV: 123 | EXP: 12/2026Master Negado N: 372938001199778
CVV: 1234 | EXP: 12/2026Amex Negado Qualquer outro cartão diferente será Autorizado pela processadora de vendas da Justa.
Valor total da venda em centavos e com valor mínimo.
O campo totalValue tem seus números contados em centavos, isso significa que o valor 500 equivale à R$5,00 (Cinco reais).
Nosso sistema permite pagamentos com parcelas (installments) de no mínimo R$5,00, ou seja, se a venda for com 2 parcelas, o totalValue deverá ter no mínimo R$10,00 para que cada parcela tenha no mínimo R$5,00 e assim por diante.
Sobre vendas pré-autorizadas.
- A pré-autorização para 29 dias está disponíveis para cartão de crédito nas bandeiras Elo, Visa e Mastercard em lojistas que estejam dentro das categorias de atuação elegíveis, lista disponível aqui.
- Ao pré-autorizar uma cobrança a mesma ficará disponível para captura de 6 até 29 dias corridos. Ou seja, caso não haja solicitação de captura, haverá o cancelamento da cobrança automaticamente após a data limite para captura
- Não está disponível a captura parcial da pré-autorização para a bandeira American Express.
- A captura da pré-autorização poderá ser feita apenas se a cobrança estiver com status autorizada.
Sobre o antifraude das vendas.
Para que haja a separação do seu estabelecimento no antifraude e consigamos adaptar as regras do motor de risco, se faz necessário que o parâmetro integradorID seja enviado, obrigatoriamente, no cabeçalho da requisição.
Outro fato importante é que, toda vez que uma venda não for autorizada e o código de erro for JST-99 ou JST-98, o grande fator que não autorizou foi o motor de risco. Em casos que o cliente pagador do estabelecimento for alguém de baixo risco - na visão de vocês -, o time de suporte pode ser acionado para calibragem do motor para que uma nova retentativa seja realizada.
Erros mapeados
Para visualizar os possíveis erros nesta API, acesse a Tabela de erros do pagamento web.