• 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

    Ambientes

    A API do Mercury está disponível em dois ambientes. O contrato da API é idêntico entre eles — mesmos endpoints, parâmetros, permissões e formatos de resposta. Muda apenas a base URL (e os dados/credenciais de cada ambiente).
    AmbienteBase URLUso
    Produçãohttps://api.wiser.cloudTráfego real de clientes.
    Sandboxhttps://sandbox-api.wiser.cloudTestes de integração sem afetar dados reais.

    Sandbox#

    O sandbox é o ambiente para desenvolver e testar sua integração antes de ir para produção:
    Dados isolados — o sandbox tem sua própria base de dados, totalmente isolada da produção. Nada que você criar ou alterar em sandbox afeta clientes ou dados reais.
    Pagamentos mockados — cobranças via cartão feitas em sandbox são simuladas: nenhuma adquirente é acionada e nenhuma cobrança real ocorre. Você pode testar fluxos de venda, renovação e cancelamento de ponta a ponta sem risco financeiro.
    Configuração sob demanda — nem toda empresa integrante tem o ambiente de sandbox habilitado por padrão. Se você tentar usar sandbox e ele ainda não estiver configurado para sua empresa, abra um chamado solicitando a habilitação.
    Para reproduzir cenários específicos de aprovação, recusa e erro nas cobranças de teste, veja Cartões de Teste.

    Como alternar de ambiente#

    Alternar de ambiente é trocar a base URL das suas requisições. Nada mais na sua integração precisa mudar.
    Comece obtendo o token no ambiente desejado e usando a mesma base URL nas chamadas seguintes. Exemplo em sandbox:
    Recomendação: mantenha a base URL em uma variável de ambiente/configuração da sua aplicação, de modo que a troca entre produção e sandbox seja apenas uma mudança de configuração.

    Credenciais e tokens por ambiente#

    As credenciais (clientId / clientSecret) são específicas de cada ambiente — credenciais de sandbox não valem em produção, e vice-versa.
    Um access_token obtido em um ambiente só é válido naquele ambiente. Sempre obtenha o token na mesma base URL em que fará as chamadas.

    Próximos passos#

    Cartões de Teste — cenários de aprovação, recusa e erro para cobranças em sandbox.
    Webhooks — receba notificações dos eventos gerados pela sua integração.
    Com o ambiente definido e o fluxo de autenticação em mãos, use a referência completa da API — organizada por recurso (Contatos, Leads, Links de Pagamento Personalizados) — para os demais endpoints, com as permissões exigidas por cada operação.
    Previous
    Autenticação
    Next
    Cartões de Teste
    Built with