Operações
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
A tabela abaixo destaca as principais operações disponíveis e suas descrições:
| Propriedade | 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 | Um 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 Tags Retorno
Ao utilizar nossa API, você receberá respostas em formato JSON com informações detalhadas sobre o status de cada operação. A tabela abaixo destaca os principais códigos de retorno e suas descrições:
| Código | Descrição |
|---|---|
| 00 | SUCESSO |
| 01 | TRANSACAO NAO AUTORIZADA PELO EMISSOR - 01 |
| 03 | TRANSACAO NAO AUTORIZADA PELO ADQUIRENTE - ESTABELECIMENTO INVALIDO - 03 |
| 04 | TRANSACAO NAO AUTORIZADA - CARTAO INVALIDO - 04 |
| 05 | TRANSACAO NAO AUTORIZADA PELO EMISSOR - 05 |
| 06 | TRANSACAO NAO AUTORIZADA - DESCONHECIDO - 06 |
| 07 | TRANSACAO NAO AUTORIZADA - CARTAO INVALIDO - 07 |
| 12 | TRANSACAO NAO AUTORIZADA - TRANSACAO INVALIDA - 12 |
| 13 | TRANSACAO NAO AUTORIZADA - VALOR INVALIDO - 13 |
| 14 | TRANSACAO NAO AUTORIZADA - CARTAO INVALIDO - 14 |
| 15 | TRANSACAO NAO AUTORIZADA - TRANSACAO INVALIDO - 15 |
| 19 | TRANSACAO NAO AUTORIZADA - FACA RETENTATIVA - 19 |
| 30 | TRANSACAO NAO AUTORIZADA - TRANSACAO INVALIDA - 30 |
| 38 | TRANSACAO NAO AUTORIZADA - SENHA INVALIDA - 38 |
| 39 | TRANSACAO NAO AUTORIZADA - TRANSACAO INVALIDA - 39 |
| 40 | TRANSACAO NAO AUTORIZADA - FUNCAO INVALIDA - 40 |
| 41 | TRANSACAO NAO AUTORIZADA - CARTAO BLOQUEADO - 41 |
| 43 | TRANSACAO NAO AUTORIZADA - CARTAO BLOQUEADO - 43 |
| 46 | TRANSACAO NAO AUTORIZADA - CONTA ENCERRADA - 46 |
| 51 | TRANSACAO NAO AUTORIZADA PELO EMISSOR - 51 |
| 52 | TRANSACAO NAO AUTORIZADA - TRANSACAO INVALIDA - 52 |
| 53 | TRANSACAO NAO AUTORIZADA - TRANSACAO INVALIDA - 53 |
| 54 | TRANSACAO NAO AUTORIZADA PELO EMISSOR - CARTAO VENCIDO - 54 |
| 55 | TRANSACAO NAO AUTORIZADA - SENHA INVALIDA - 55 |
| 57 | TRANSACAO NAO AUTORIZADA PELO EMISSOR - 57 |
| 58 | TRANSACAO NAO AUTORIZADA - NAO PERMITIDA PARA O ESTABELECIMENTO - 58 |
| 59 | TRANSACAO NAO AUTORIZADA PELO EMISSOR - CARTAO SUSPENSO - 59 |
| 61 | TRANSACAO NAO AUTORIZADA - EXCEDEU LIMITE - 61 |
| 62 | TRANSACAO NAO AUTORIZADA - CARTAO RESTRITO - 62 |
| 63 | TRANSACAO NAO AUTORIZADA - SENHA INVALIDA - 63 |
| 65 | TRANSACAO NAO AUTORIZADA PELO EMISSOR - 65 |
| 70 | TRANSACAO NAO AUTORIZADA - DESCONHECIDO 70 |
| 75 | TRANSACAO NAO AUTORIZADA - SENHA INVALIDA - 75 |
| 78 | TRANSACAO NAO AUTORIZADA - CARTAO BLOQUEADO. - 78 |
| 79 | TRANSACAO NAO AUTORIZADA - Card Fraud/Security - 79 |
| 82 | TRANSACAO NAO AUTORIZADA - Card Fraud/Security - 82 |
| 83 | TRANSACAO NAO AUTORIZADA - Card Fraud/Security - 83 |
| 91 | TRANSACAO NAO AUTORIZADA - BANDEIRA/EMISSOR INDISPONIVEL - 91 |
| 93 | TRANSACAO NAO AUTORIZADA - CARTAO INVALIDO - 93 |
| 94 | TRANSACAO NAO AUTORIZADA - TRANSACAO DUPLICADA - 94 |
| 96 | TRANSACAO NAO AUTORIZADA - ERRO DE PROCESSAMENTO - 96 |
Cartões de Teste para Operações Homologação
Você pode utilizar 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 "digital" de homologação pode ser definida conforme a necessidade do cliente, basta realizar alterações nos campos para definir testes de cartão expirado ou não.
Ao setar uma data futura, o cartão só irá vencer no mês/ano estipulado, já ao colocar qualquer data inferior, o sistema apresentará o erro de cartão expirado.
Cartões para teste 3DS
Utilize os cartões abaixo para simular diferentes cenários de autenticação 3DS em ambiente de homologação:
| Bandeira | Número do Cartão (PAN) | Cenário |
|---|---|---|
| VISA | 4000 0000 0000 2503 | Autenticação com desafio tradicional concluída com sucesso |
| VISA | 4000 0000 0000 2370 | Autenticação com desafio tradicional falhou devido a resposta incorreta do titular do cartão. |
| VISA | 4000 0000 0000 2420 | Autenticação com desafio está indisponível nesse momento |
| VISA | 4000 0000 0000 2644 | Sistema de autenticação com desafio falhou durante o processo |
| VISA | 4000 0000 0000 2701 | Autenticação sem desafio bem-sucedida, representando que o portador do cartão foi autenticado pelo emissor. |
| VISA | 4000 0000 0000 2925 | Autenticação falhou pelo Emissor do cartão sem desafio |
| VISA | 4000 0000 0000 2719 | O titular do cartão está inscrito no 3DS, mas o Emissor não está dando suporte ao programa, resultando em uma experiência de autenticação alternativa. |
| VISA | 4000 0000 0000 2313 | Autenticação está indisponível nesse momento |
| VISA | 4000 0000 0000 2537 | Autenticação rejeitada pelo emissor sem exigir um desafio. |
| VISA | 4000 0000 0000 2990 | Autenticação não disponível na consulta devido a erro do sistema. |
| VISA | 4000 0000 0000 2446 | Um erro inesperado ocorreu durante a fase posterior do processamento de autenticação. |
| VISA | 4000 0000 0000 2354 | Excedido o tempo limite durante o processamento da mensagem cmpi_lookup, resultando em um erro na transação. |
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 ou clientes.
- Acompanhe nossas atualizações para estar em conformidade com as normas mais recentes do setor.
Para dúvidas ou problemas, acesse a seção de suporte no