API Key de sandbox usada em produção

Esse erro ocorre quando a integração utiliza a URL de produção com uma API Key gerada no sandbox.

Como identificar

• a integração funciona no sandbox, mas falha em produção;
• o erro começou após a troca de ambiente;
• somente a URL foi alterada;
• a origem da API Key não está clara.

Como corrigir

1. Confirme se a URL utilizada é de produção.
2. Verifique em qual ambiente a API Key foi gerada.
3. Substitua a chave pela API Key de produção.
4. Faça uma chamada autenticada simples.
5. Após a validação, teste o fluxo principal.

Fluxo de diagnóstico

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7
}}}%%
flowchart TD
    A["Integração falhou após a troca para produção"] --> B{"A URL utilizada é de produção?"}

    B --> BSim(("Sim"))
    B --> BNao(("Não"))

    BNao --> C["Corrigir a URL para produção"]
    C --> D["Testar novamente"]

    BSim --> E{"A API Key foi gerada em produção?"}

    E --> ESim(("Sim"))
    E --> ENao(("Não"))
    E --> EDuvida(("Não sabe"))

    ENao --> F["Gerar ou localizar a API Key de produção"]
    EDuvida --> F
    F --> G["Atualizar a credencial na aplicação"]

    ESim --> H{"A variável de ambiente foi atualizada?"}

    H --> HSim(("Sim"))
    H --> HNao(("Não"))

    HNao --> G
    HSim --> I["Realizar uma chamada autenticada simples"]
    G --> I

    I --> J{"A autenticação funcionou?"}

    J --> JSim(("Sim"))
    J --> JNao(("Não"))

    JSim --> K["Testar o fluxo principal"]
    K --> L["Continuar o go-live"]

    JNao --> M["Verificar outras causas de autenticação"]
    M --> N["Coletar dados da tentativa"]
    N --> O["Encaminhar para análise técnica"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef decisao fill:#FEF3C7,stroke:#D97706,color:#78350F,stroke-width:3px
    classDef correcao fill:#FFEDD5,stroke:#EA580C,color:#7C2D12,stroke-width:2px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px
    classDef analise fill:#FEE2E2,stroke:#DC2626,color:#7F1D1D,stroke-width:3px

    classDef respostaSim fill:#22C55E,stroke:#15803D,color:#FFFFFF,stroke-width:3px
    classDef respostaNao fill:#EF4444,stroke:#B91C1C,color:#FFFFFF,stroke-width:3px
    classDef respostaDuvida fill:#8B5CF6,stroke:#6D28D9,color:#FFFFFF,stroke-width:3px

    class A inicio
    class B,E,H,J decisao
    class C,F,G correcao
    class D,I,K validacao
    class L sucesso
    class M,N,O analise

    class BSim,ESim,HSim,JSim respostaSim
    class BNao,ENao,HNao,JNao respostaNao
    class EDuvida respostaDuvida

    linkStyle default stroke:#94A3B8,stroke-width:2px

    linkStyle 1,6,13,19 stroke:#22C55E,stroke-width:4px
    linkStyle 2,7,14,20 stroke:#EF4444,stroke-width:4px
    linkStyle 8 stroke:#8B5CF6,stroke-width:4px2

Como prevenir

Mantenha URLs e credenciais separadas por ambiente e inclua essa validação no checklist de go-live.

A API Key do sandbox não funciona em produção.