Cenários de Teste
No ambiente de sandbox, você pode testar diferentes cenários de transações para entender como a API responde em diversas situações. Por padrão, todas as tentativas de autorização são configuradas para serem aprovadas. Para simular outros fluxos, utilize os seguintes cartões de teste ou tokens temporários:
Cartões de Teste
| Número do Cartão | Cenário de Teste | Descrição do Resultado |
|---|---|---|
| 4389355432185991 | Autorização Negada | Este cartão simula um cenário onde a autorização é negada. Utilize-o para testar como sua aplicação lida com transações negadas. |
| 4716100289307782 5597773670668839 | 3DS Setup | Estes cartões simulam um cenário onde a configuração de 3Ds é autorizada. |
| 5466245842998772 | 3DS Enrollment - Rejeitado | Este cartão simula um cenário onde a inscrição de 3DS é rejeitada. Utilize-o para testar como sua aplicação lida com transações 3DS enrollment rejeitadas. |
| 5245581323894413 | 3DS Enrollment - com Desafio | Este cartão simula um cenário onde a inscrição de 3DS gera um desafio. Utilize-o para testar como sua aplicação lida com transações 3DS enrollment que geram um desafio. |
| 4389355432185992 | Erro Interno | Este cartão provoca um erro interno no servidor (Erro 500). Use-o para verificar a robustez da sua aplicação em lidar com falhas inesperadas na API. |
Tokens Temporários de Teste
| Token Temporário | Cenário de Teste | Descrição do Resultado |
|---|---|---|
| card_t/BIChj63GkO650jVX0xSsIeRD03GxDY | Autorização Negada | Este token simula um cenário onde a autorização é negada. Utilize-o para testar como sua aplicação lida com transações negadas. |
| card_ZVHmBRSw3EjkJ7s93Vm4S5FiZwuQjgTi card_RtyG5hOw3EiJ8EJbwFHGQJJNDB0pqBXJ | 3Ds Setup | Estes tokens simulam um cenário onde a configuração de 3Ds é autorizada. |
| card_icZKwUvB3EgIJiPqTLXwQZBdcls8Hx5t | 3DS Enrollment - Rejeitado | Este token simula um cenário onde a inscrição de 3DS é rejeitada. Utilize-o para testar como sua aplicação lida com transações 3DS enrollment rejeitadas. |
| card_7HdM7UvB3EgC0FQQ1/LSS5gF8OU5Ie6r | 3DS Enrollment - com Desafio | Este token simula um cenário onde a inscrição de 3DS gera um desafio. Utilize-o para testar como sua aplicação lida com transações 3DS enrollment que geram um desafio. |
| card_t/CIChk54HlP760kWY1yTtJfSE14HyEZ | Erro Interno | Este token provoca um erro interno no servidor (Erro 500). Use-o para verificar a robustez da sua aplicação em lidar com falhas inesperadas na API. |
CardId de Teste
| CardId | Cenário de Teste | Descrição do Resultado |
|---|---|---|
| 45ece197-1936-4dd9-bc5e-eea93a0461e6 | Autorização Negada | Este cardId simula um cenário onde a autorização é negada. Utilize-o para testar como sua aplicação lida com transações negadas. |
| 89ece197-1936-4dd9-bc5e-eea93a0461e6 | Erro Interno | Este cardId provoca um erro interno no servidor (Erro 500). Use-o para verificar a robustez da sua aplicação em lidar com falhas inesperadas na API. |
Testes de timeout
| Endpoint | Campo - Valor | Descrição do Resultado |
|---|---|---|
| /charge/pix | transactions.pix.expiration - 321 | Passar 321 para o período de expiração do PIX provocará um erro de comunicação interna por timeout (erro 502). Use-o para verificar a robustez da sua aplicação em lidar com falhas inesperadas na API. |
| /charge/wallet | customer.name - Pessoa timeout | Passar Pessoa timeout no nome do cliente provocará um erro de comunicação interna por timeout (erro 502). Use-o para verificar a robustez da sua aplicação em lidar com falhas inesperadas na API. |
Endpoint de Autorização 3DS
Este endpoint simula o momento final da autenticação 3DS, em que a transação é aprovada ou rejeitada após os passos prévios de configuração e inscrição.
Para testar este endpoint com sucesso no sandbox, você deve primeiro passar pelos endpoints de Setup e Enrollment do 3DS com um cartão ou token de teste válido.
Isso irá gerar um chargeId que será aceito neste endpoint. Caso você tente utilizar um chargeId que não passou pelas etapas anteriores, receberá o seguinte erro:
{
"message": "3D Secure Authentication not found with chargeId: ff46de80-f29b-4ed5-8d24-bdad5f49a8d7",
"success": false
}
Cenários para simulação
Por padrão, todas as requisições válidas para este endpoint são aprovadas. Para simular falhas, utilize os seguintes valores de CVV:
| Cenário | Descrição | Campo | Valor |
|---|---|---|---|
| Erro 500 | Retorna um erro padrão 500 | CVV | 500 |
| Erro 400 | Retorna uma resposta padrão de erro 400 (Bad Request) para este endpoint | CVV | 400 |
Para simular o fluxo completo com sucesso:
- Use um cartão/token de 3DS Setup válido.
- Em seguida, simule o 3DS Enrollment, também com sucesso.
- Guarde o chargeId gerado.
- Com esse chargeId, chame o endpoint de autorização 3DS e utilize os valores acima para testar respostas diferentes.
Dicas para Testes de Cenários
- Certifique-se de testar todos os cenários para garantir que sua aplicação possa lidar com diferentes respostas da API.
- Observe como sua aplicação trata os erros e as mensagens de resposta fornecidas pela API.
Utilizando esses cartões ou tokens em seus testes no ambiente de sandbox, você poderá preparar sua aplicação para lidar com uma variedade de situações que podem ocorrer em um ambiente de produção.