• Primeiros Passos
    • Autenticação
    • Ambientes
    • Cartões de Teste
    • Pagamento de Fatura Checkout
    • Pagamento de Faturas de uma Venda
    • Webhooks
    • Captação de Leads e Venda por LP Externa
    • Erros
    • Limites de Requisição
    • Autenticação
      • Troca clientId/clientSecret por um token de acesso
        POST
    • Leads
      • Cria um lead
        POST
      • Atualiza um lead
        PATCH
    • Contatos
      • Consulta um contato por e-mail
        GET
      • Consulta um contato por id
        GET
      • Atualiza um contato
        PATCH
    • Links de Pagamento Personalizados
      • Lista links de pagamento
        GET
      • Cria um link de pagamento personalizado
        POST
      • Simula o cronograma de cobrança de um link de pagamento
        POST
      • Consulta um link de pagamento
        GET
      • Cancela um link de pagamento
        POST
      • Atualiza a expiração de um link de pagamento
        PATCH

    Cartões de Teste

    No ambiente de sandbox, cobranças via cartão são simuladas — nenhuma adquirente é acionada e nenhuma cobrança real ocorre. Use os números abaixo para reproduzir cenários específicos de aprovação, recusa e erro ao testar sua integração.
    O formato exato da resposta (campos e mensagens de erro) para cada cenário está documentado na referência da API, no schema de resposta de cada operação de cobrança.

    Cartões de pagamento#

    Sucesso#

    Qualquer número de cartão não listado abaixo simula uma cobrança aprovada.

    Cenários de recusa#

    Esses cartões simulam recusas da adquirente:
    NúmeroBandeiraCenário
    4485625769572371VisaNúmero de cartão inválido
    5507414678280546MastercardSaldo insuficiente
    4485452912512141VisaAutorização expirada
    5573984336048997MastercardCódigo de segurança inválido
    5383700116661480MastercardAlerta de fraude

    Erro sistêmico#

    Esse cartão simula uma falha de comunicação com a adquirente (timeout/indisponibilidade), útil para testar o comportamento da sua integração quando a cobrança não pode ser completada:
    NúmeroBandeiraCenário
    4000000000000119VisaFalha de conexão (timeout)

    Valores de estorno#

    Ao testar um estorno, o valor em centavos enviado na requisição determina o cenário simulado — independentemente do cartão usado na cobrança original.

    Sucesso#

    Qualquer valor não listado abaixo simula um estorno aprovado.

    Cenários de erro#

    Valor (centavos)Cenário
    1221Recurso não encontrado
    2332Erro de validação de campo
    3443Valor acima do limite permitido
    4554Credencial inválida

    Notas#

    Cancelamento de uma cobrança sempre simula sucesso, independentemente do cartão usado.
    Captura de uma cobrança pré-autorizada sempre simula sucesso.
    O cartão de erro sistêmico (4000000000000119) é o único que simula uma falha sem resposta — os demais cartões de recusa sempre retornam uma resposta com o motivo da recusa.

    Próximos passos#

    Webhooks — receba notificações dos eventos gerados pelas cobranças de teste.
    Previous
    Ambientes
    Next
    Pagamento de Fatura Checkout
    Built with