Sandbox de gateway de pagamento simulado
Aprenda como uma API de pagamento responde: simule aprovações, recusas e 3-D Secure com cartões de teste publicados — totalmente off-line.
🔒 Simulador educativo: não se comunica com nenhum banco, rede de cartões ou provedor de pagamento. Apenas números de cartão de teste publicados são aceitos.
Números de cartão de teste publicados
| Número do cartão | Rede | Resultado simulado | |
|---|---|---|---|
| 4242 4242 4242 4242 | Visa | Pagamento bem-sucedido | |
| 4000 0000 0000 0002 | Visa | Recusado: generic_decline | |
| 4000 0000 0000 9995 | Visa | Recusado: insufficient_funds | |
| 4000 0000 0000 0069 | Visa | Recusado: expired_card | |
| 4000 0000 0000 0127 | Visa | Recusado: incorrect_cvc | |
| 4000 0000 0000 0119 | Visa | Erro: processing_error | |
| 4000 0025 0000 3155 | Visa | Exige autenticação 3-D Secure | |
| 5555 5555 5555 4444 | Mastercard | Pagamento bem-sucedido | |
| 3782 822463 10005 | American Express | Pagamento bem-sucedido |
Como funciona o fluxo de pagamento
Seu servidor cria e confirma um payment intent, o gateway responde com um status e, depois, um webhook informa ao seu backend o resultado final. Processe os pedidos a partir do webhook, não do redirecionamento do navegador.
{
"method": "POST",
"path": "/v1/payment_intents",
"body": {
"amount": 2000,
"currency": "usd",
"confirm": true,
"payment_method_data": {
"type": "card",
"card": {
"number": "4242424242424242",
"exp_month": 12,
"exp_year": 2030,
"cvc": "123"
}
}
}
}{
"id": "pi_test_3kq9x2m7v1c8b5n4z6a0d2f1",
"object": "payment_intent",
"livemode": false,
"amount": 2000,
"currency": "usd",
"status": "succeeded",
"payment_method": {
"type": "card",
"card": {
"brand": "visa",
"last4": "4242",
"exp_month": 12,
"exp_year": 2030
}
},
"latest_charge": {
"id": "ch_test_8h2j4k6l1m3n5p7q9r0s2t4u",
"authorization_code": "T4K2Q9",
"outcome": {
"network_status": "approved_by_network",
"type": "authorized"
}
}
}{
"id": "evt_test_1a2b3c4d5e6f7g8h9i0j1k2l",
"object": "event",
"type": "payment_intent.succeeded",
"livemode": false,
"data": {
"object": {
"id": "pi_test_3kq9x2m7v1c8b5n4z6a0d2f1",
"status": "succeeded",
"amount": 2000,
"currency": "usd"
}
}
}{
"id": "evt_test_9z8y7x6w5v4u3t2s1r0q9p8o",
"object": "event",
"type": "payment_intent.payment_failed",
"livemode": false,
"data": {
"object": {
"id": "pi_test_7f6e5d4c3b2a1z0y9x8w7v6u",
"status": "requires_payment_method",
"last_payment_error": {
"type": "card_error",
"code": "card_declined",
"decline_code": "insufficient_funds",
"message": "Your card has insufficient funds."
}
}
}
}Sobre a ferramenta Sandbox de gateway de pagamento simulado
Este sandbox de gateway de pagamento simulado permite que desenvolvedores aprendam como uma API de pagamento com cartão responde, sem mexer em dinheiro real. Escolha um dos números de cartão de teste publicados, informe qualquer data de validade futura, um CVC e um valor, e clique em Simular pagamento. A página retorna um objeto JSON no formato de um payment intent típico: um id, um status, a rede do cartão e os quatro últimos dígitos, um código e uma mensagem de recusa em caso de falha e um código de autorização fictício nas aprovações. O cartão 3-D Secure exibe um desafio simulado para que você pratique o tratamento do status requires_action, e cada resultado inclui o evento de webhook correspondente. O simulador é executado inteiramente no seu navegador: ele não se comunica com nenhum banco, rede de cartões ou provedor de pagamento e aceita apenas os números de teste publicados listados na tabela. Números de cartão reais são rejeitados localmente e nunca são enviados a lugar nenhum.
FAQ
O sandbox cobra um cartão ou se comunica com um banco?
Não. Tudo é simulado no seu navegador. Nenhuma requisição é enviada à Visatk, a um banco, a uma rede de cartões ou a um provedor de pagamento, e nenhum dinheiro é movimentado.
Por que meu número de cartão é rejeitado?
O sandbox aceita apenas os números de teste publicados na tabela. Qualquer outro número, incluindo um cartão real, é recusado localmente para nunca ser tratado como aprovado.
Posso usar estes números no meu provedor de pagamento real?
Estes são os números de teste amplamente publicados usados nos modos de teste dos provedores. Eles funcionam apenas com chaves de API de teste no sandbox do seu provedor; no modo de produção são sempre recusados.