StafeBank Gateway
    StafeBank Gateway
    • Overview
    • Webhooks
    • Error codes
    • Ambiente de Testes
    • Transactions
      • Criar uma Transação
        POST
      • Criar uma Transação Com 3DS
        POST
      • Criar uma Transação PIX
        POST
      • Estornar uma transação
        POST
      • Capturando uma Transação
        POST
      • Buscar Transação
        GET
      • Listar Transações
        GET
      • Retornar Histórico de uma Transação
        GET
      • Retornar Parcelas de uma transação
        GET
    • Payment Links
      • Criar Link
        POST
      • Atualizar Link
        PUT
      • Buscar Link
        GET
      • Listar Links
        GET
      • Transações de um link
        GET
    • Customer
      • Criar Cliente
        POST
      • Encontrar Cliente
        POST
      • Cartões do Cliente
        POST
      • Atualizar Cliente
        PUT
      • Buscar Cliente
        GET
      • Listar Clientes
        GET
      • Deletar um cliente
        DELETE
    • Cards
      • Criar Cartão
        POST
      • Obter Bandeira
        POST
      • Buscar Cartão
        GET
      • Listar Cartões
        GET
    • Webhook
      • Criar um webhook
      • Atualizar Webhook
      • Retornar Webhooks Cadastrados
      • Retornar um Webhook
      • Remover um Webhook
    • Simulate
      • Tax
    • Recurrence
      • Plans
        • Create Plan
        • Update Plan
        • Get a Plan
        • List Plans
      • Subscription
        • Create Subscription
        • Cancel Subscription
        • GET Subscription

    Ambiente de Testes

    Ambiente de Testes#

    O ambiente de testes está disponível por meio de uma conta de desenvolvedor (conta de teste).
    Ele utiliza os mesmos endpoints da produção, mas com regras específicas para simulação de comportamentos.
    Não há comunicação real com adquirentes, bancos ou instituições financeiras.
    Esse ambiente permite que você valide os fluxos de integração da sua aplicação de forma segura, sem impacto financeiro.
    No ambiente de testes, você poderá:
    Simular transações de cartão com diferentes resultados (aprovado, autorizado, recusado ou pendente).
    Gerar transações PIX que mudam de status automaticamente após alguns minutos, representando o fluxo real de confirmação de pagamento.
    Executar capturas e estornos para validar como sua aplicação lida com valores parciais ou totais.
    Receber identificadores fictícios (TID, NSU, códigos de autorização) a cada requisição, sem validade real, apenas para testes de fluxo.
    Forçar diferentes cenários de resposta a partir dos dados enviados, permitindo validar integrações em todos os possíveis status de uma transação.
    Esse ambiente foi projetado para reproduzir situações comuns que ocorrem em produção, mas sem impacto financeiro real.
    Ao testar, acompanhe as mudanças de status retornadas pela API para garantir que sua aplicação esteja preparada para lidar com cada caso.

    Simulação de Transações com Cartão#

    No ambiente de testes é possível simular diferentes resultados de autorização de cartão.
    O comportamento é definido a partir do último dígito do número do cartão utilizado no request Criar uma Transação.
    Último dígito do cartãoResultado da simulação
    9Retorna um status aleatório entre PAID, AUTHORIZED ou REFUSED.
    8, 7, 6, 5Sempre retorna REFUSED.
    4, 3, 2, 1Se a transação for de captura imediata, retorna PAID.
    Caso contrário, retorna AUTHORIZED.
    0 (ou outro valor)Sempre retorna WAITING_PAYMENT.
    💡
    Observação
    Caso a transação esteja configurada para utilizar 3DS, e o status inicial seja PAID ou AUTHORIZED, o fluxo será redirecionado para autenticação.
    Nesse caso, o status retornado será REQUEST_AUTHENTICATION junto de uma URL de simulação.

    Simulação de Transações PIX#

    No ambiente de testes é possível simular diferentes resultados para pagamentos via PIX.
    A transação deve ser criada utilizando o request Criar uma Transação PIX.
    Após a criação, a transação será retornada inicialmente com status WAITING_PAYMENT.
    Automaticamente será enfileirado um processamento interno que altera o status da transação após um atraso aleatório de 1 a 4 minutos.
    Valor da transação (amount)Resultado da simulação
    600Sempre retorna REFUSED.
    700Sempre retorna CANCELED.
    Qualquer outro valorSempre retorna PAID.
    💡
    Observação
    O atraso de atualização do status (1 a 4 minutos) é aplicado para simular o comportamento real de compensação de um pagamento PIX.
    Caso o resultado seja REFUSED, também será preenchido o campo refuse_reason com um motivo fictício de recusa.

    Simulação de Boletos#

    No ambiente de testes não há simulação de transações via boleto.
    Esse meio de pagamento não gera comportamentos automáticos de aprovação, recusa ou compensação dentro do ambiente de testes.
    Modificado em 2025-09-12 16:26:16
    Página anterior
    Error codes
    Próxima página
    Criar uma Transação
    Built with