Teste de integração
O teste de integração permite analisar se ela foi realizada corretamente e se os pagamentos estão sendo processados sem erros, evitando possíveis problemas ao disponibilizar o checkout para os compradores finais.
Para realizar esses testes, você precisará:
- Usuário de teste: possui as mesmas funcionalidades que um usuário real do Mercado Pago, permitindo testar o funcionamento do seu desenvolvimento sem comprometer dados reais. Para criá-lo, acesse Suas integrações e logo Contas de teste > Criar contas de teste.
- Cartões de teste: utilize cartões de teste de métodos de pagamento locais e simule diferentes respostas de pagamento, sem necessidade de usar um cartão real.
Siga os passos abaixo para testar sua integração.
1. Fazer login com o usuário de teste e obter credenciais
Para realizar uma compra de teste, você deve usar as credenciais de produção do usuário de teste criado.
Para obtê-las, faça login em uma janela de navegação anônima usando o usuário e a senha fornecidos ao criá-lo.
Em seguida, vá para Detalhes da aplicação > Credenciais dentro de Suas integrações. Lá você encontrará a Public Key e o Access Token do usuário de teste.
Por fim, utilize essas credenciais para realizar as requisições necessárias para continuar com a compra de teste.
2. Realizar uma compra de teste
Para realizar uma compra de teste, você precisará simular um usuário comprador na loja.
- Selecione um produto ou serviço e inicie o processo de compra.
- No checkout da loja, insira o e-mail. Lembre-se de que ele deve ser diferente do e-mail que você usa no Mercado Pago.
- Insira os dados de um de nossos cartões de teste.
- Confirme a compra.
Cartões de teste
Você pode utilizar cartões de teste de métodos de pagamento locais e simular diferentes respostas dos pagamentos, sem a necessidade de usar um cartão real.
Para isso, de acordo com o seu país, utilize algum dos cartões de crédito ou débito que disponibilizamos a seguir.
Cartões de crédito
Cartão | Número | Código de segurança | Data de vencimento |
Mastercard | 5474 9254 3267 0366 | 123 | 11/25 |
Visa | 4075 5957 1648 3764 | 123 | 11/25 |
Cartões de débito
Cartão | Número | Código de segurança | Data de vencimento |
Mastercard | 5579 0534 6148 2647 | 123 | 11/25 |
Visa | 4189 1412 2126 7633 | 123 | 11/25 |
Para testar diferentes resultados de pagamento, preencha o status desejado no nome do titular do cartão (campo card_holder_name
):
Status de pagamento | Descrição |
APRO | Pagamento aprovado |
OTHE | Recusado por erro geral |
CONT | Pagamento pendente |
CALL | Recusado com validação para autorizar |
FUND | Recusado por quantia insuficiente |
SECU | Recusado por código de segurança inválido |
EXPI | Recusado por problema com a data de vencimento |
FORM | Recusado por erro no formulário |
CARD | Rejeitado por falta de card_number |
INST | Rejeitado por parcelas inválidas |
DUPL | Rejeitado por pagamento duplicado |
LOCK | Rejeitado por cartão desabilitado |
CTNA | Rejeitado por tipo de cartão não permitido |
ATTE | Rejeitado devido a tentativas excedidas de pin do cartão |
BLAC | Rejeitado por estar na lista negra |
UNSU | Não suportado |
TEST | Usado para aplicar regra de valores |
3. Verificar a compra de teste
Para verificar se a compra de teste foi bem-sucedida, envie um GET para o endpoint /v1/orders/{id}, substituindo id
pela identificação da order, recebida na resposta à sua criação.
Pronto! Uma vez concluídos esses passos, a integração estará completa e você poderá usar suas credenciais de produção no Checkout API.
Requisitos para entrar em produção
Ao finalizar o processo de integração, o ambiente estará pronto para ser colocado em produção. Veja abaixo os requisitos necessário para realizar essa mudança de maneira eficaz e segura, garantindo que a integração esteja preparada para o recebimento de transações reais.
1. Ativar credenciais de produção
Para começar a receber pagamentos, você deve ativar as credenciais de produção de seu usuário real e substituir as credenciais de seu usuário de teste.
Para isso, acesse o Painel do Desenvolvedor e, no menu lateral, acesse Produção > Credenciais de Produção. Ali você encontrará seu Public Key e Access Token produtivos, que devem substituir os de teste utilizados nas etapas anteriores.
Para obter mais informações, consulte nossa documentação sobre Credenciais.
2. Implementar certificado SSL
Para garantir uma integração segura e que proteja os dados de cada transação, é necessário implementar um certificado SSL. Além disso, é importante que a forma de pagamento seja disponibilizada em uma página web que utilize o protocolo HTTPS. Este protocolo assegura a criptografia dos dados transmitidos entre o cliente e o servidor.
Adotar estas medidas não apenas reforça a segurança dos dados dos usuários, mas também assegura a conformidade com as normativas e leis específicas de cada país relativas à proteção de dados e à segurança da informação. Além disso, contribui significativamente para proporcionar uma experiência de compra mais segura e confiável.
Embora a exigência do certificado SSL não se aplique durante o período de testes, sua implementação é obrigatória para entrar em produção. Para mais informações, confira os termos e condições do Mercado Pago.
3.Configurar notificações
Mantenha o status dos pedidos atualizados em seus sistemas, usando e processando as notificações Webhooks.