Introdução às Operações da API
Antes de explorar os recursos oferecidos pela API, é essencial entender os conceitos-chave no processamento de transações com cartão de crédito. Essas operações são fundamentais para garantir um fluxo seguro e eficiente em seu e-commerce.
Principais Operações
| Operação | Descrição |
|---|---|
| Pagamento | A principal operação no e-commerce, pois é através dela que uma venda pode ser concretizada |
| Cancelamento | Utilizado quando é necessário desfazer uma venda no mesmo dia em que foi realizada |
| Autenticação | Processo que adiciona uma camada de segurança à venda, validando-a no Gateway de Pagamentos |
| Tokenização | Permite realizar transações seguras substituindo o número do cartão por um token |
Tabela de Códigos de Retorno (Tags)
Ao utilizar nossa API, você receberá respostas em formato JSON com informações detalhadas sobre o status de cada operação. Consulte a página de Códigos de Resposta para visualizar a tabela completa com todos os códigos de retorno.
Cartões de Teste — Ambiente de Homologação
Utilize os cartões abaixo para testar as operações em ambiente de homologação:
| Bandeira | Número do Cartão (PAN) | Validade | CVV |
|---|---|---|---|
| Mastercard | 5200 0000 0000 2151 | 09/30 | 123 |
| Visa | 4000 0000 0000 2503 | 12/30 | 123 |
| AMEX | 3400 0000 0000 2534 | 10/30 | 1234 |
| Hipercard | 6062 8288 9854 1988 | 09/30 | 123 |
| ELO | 6505 2900 0000 2190 | 11/30 | 123 |
A data de expiração dos cartões no ambiente de homologação pode ser definida conforme a necessidade. Ao setar uma data futura, o cartão só irá vencer no mês/ano estipulado; ao colocar qualquer data inferior, o sistema apresentará o erro de cartão expirado.
Dicas para Desenvolvedores
- Utilize sempre conexões seguras (HTTPS) ao consumir a API
- Gerencie tokens de autenticação com cuidado, evitando exposições em logs
- Acompanhe as atualizações para estar em conformidade com as normas mais recentes do setor