Chaves de checkout e chaves de caixa
As chaves de checkout e as chaves de caixa proporcionam uma robusta conformidade com PCI DSS, separando de forma segura as sessões de pagamento front-end da liquidação back-end do MID. Utilizam a geração assíncrona de chaves para proteger dados sensíveis de titulares de cartão.
- Categoria
- Programador
- Funcionalidades
- 6
- Disponível em
- Todos os planos
A Cardflo utiliza Chaves de Checkout e Chaves de Caixa para fornecer opções de integração seguras e flexíveis para os comerciantes.
As Chaves de Checkout gerem o início da sessão de pagamento e a recolha de dados do cliente, enquanto as Chaves de Caixa facilitam o processamento de transações do lado do servidor.
Esta separação garante a conformidade com o PCI e uma segurança robusta para todos os fluxos de pagamento.
A implementação de chaves de checkout e de caixa proporciona uma tokenização robusta, isolando dados de pagamento sensíveis das interações de front-end. Este design arquitetónico melhora significativamente a conformidade com o PCI DSS e reforça a segurança geral dos seus fluxos de pagamento.
Visão geral de Chaves de checkout e chaves de caixageral
A separação de credenciais em chaves de checkout e chaves de caixa representa uma arquitetura de segurança fundamental na orquestração de pagamentos moderna.
As chaves de checkout são identificadores públicos usados em ambientes do lado do cliente, como navegadores web ou aplicações móveis, para inicializar componentes de pagamento e recolher dados sensíveis do titular do cartão. Estas chaves permitem que um comerciante renderize uma interface de checkout sem expor permissões sensíveis de backend.
Por outro lado, as chaves de caixa são credenciais restritas do lado do servidor, projetadas para comunicação autenticada entre um servidor de comerciante e o gateway de pagamento.
Ao bifurcar estas funções, o sistema garante que um comprometimento do código do lado do cliente não concede a um atacante a capacidade de realizar ações administrativas, como iniciar reembolsos ou capturar pagamentos autorizados.
Esta abordagem arquitetónica ajuda a manter a conformidade com o PCI DSS, minimizando o âmbito dos sistemas que interagem diretamente com credenciais de pagamento brutas, ao mesmo tempo que permite um controlo programável e granular sobre os ciclos de vida das transações.
Como funciona Chaves de checkout e chaves de caixafunciona
Início da sessão do lado do cliente
A integração começa com a chave de checkout a ser utilizada na aplicação frontend para solicitar uma sessão segura. Esta chave identifica a identidade do comerciante (MID) e autoriza a renderização de elementos de pagamento seguros, garantindo que os detalhes do cartão do cliente são tokenizados antes de chegarem à infraestrutura do comerciante.
Tokenização segura de dados
À medida que o cliente insere os seus detalhes de pagamento, a chave de checkout facilita uma ligação direta ao cofre. Campos sensíveis como o PAN e o CVV são convertidos em tokens temporários. Este processo garante que o ambiente do comerciante permanece fora do âmbito principal dos requisitos do PCI DSS.
Autorização servidor-a-servidor
Assim que um token é gerado, o servidor do comerciante usa a sua chave de caixa para solicitar uma autorização formal do adquirente. Esta chave privada confirma que o pedido é legítimo e permite que o gateway mapeie o token temporário de volta para os dados de pagamento armazenados para processamento.
Porque é que Chaves de checkout e chaves de caixa é importante
Mitigação de riscos e responsabilidades
A divisão de credenciais reduz o raio de explosão de uma potencial violação de segurança. Se uma chave de checkout for intercetada do código-fonte de um website, o atacante não pode usá-la para levantar fundos ou aceder a registos de transações históricas. A chave de caixa permanece protegida num backend seguro, garantindo que apenas ambientes de servidor autorizados podem executar movimentos financeiros, o que é uma defesa crítica contra ataques de injeção comuns.
Conformidade simplificada com o PCI DSS
Ao utilizar chaves de checkout para lidar com dados do titular do cartão através de campos ou componentes alojados, os comerciantes geralmente qualificam-se para uma carga de conformidade reduzida, como SAQ A ou SAQ A-EP. A chave de caixa garante que os dados sensíveis são tratados num formato tokenizado no backend, eliminando a necessidade de o comerciante armazenar, processar ou transmitir informações de cartão de crédito brutas nos seus próprios servidores.
Notas regulamentares para Chaves de checkout e chaves de caixa
PCI DSS compliance and credential scope
The Payment Card Industry Data Security Standard mandates strict logical separation between public-facing data collection systems and internal financial processing infrastructure.
Utilising heavily restricted checkout authentication keys significantly limits the scope of client-side vulnerabilities, as this public string only permits the initial generation of encrypted tokens.
By processing actual financial captures through securely stored backend strings, engineering teams prevent their merchant servers from ever touching raw Primary Account Numbers.
The tokenised payload travels safely through the orchestration layer directly to acquirer partners, reducing the overall merchant compliance burden to a simplified self-assessment questionnaire.
Cryptographic standardisation and secure storage
Financial scheme rules explicitly require that any credential capable of authorising live money movement must be protected by robust cryptographic algorithms and rotated following strict enterprise security protocols.
Merchant systems must transmit these cashier identifiers over verified transport layer security connections to prevent man-in-the-middle interception during processing.
Enforcing regular credential rotation schedules directly reflects recognised information-security practice for access control and secret management. Maintaining distinct architectural environments for testing and production ensures that live cashier credentials remain totally isolated, mitigating the risk of accidental exposure during complex software deployment or debugging exercises.
Casos de uso de Chaves de checkout e chaves de caixacasos de uso
Inicialização de checkout de página única
Um checkout de página única deve expor uma chave de checkout pública para inicializar o SDK do lado do cliente sem revelar a chave secreta do caixa usada para criar ou confirmar sessões de pagamento. O Cardflo separa as credenciais seguras do navegador dos segredos mantidos no servidor e suporta a substituição com escopo quando uma chave pública é exposta.
Isolamento de credenciais de carrinho incorporado
Uma integração WooCommerce ou Shopify pode renderizar componentes de pagamento Cardflo através de um tema, extensão ou script de loja onde as chaves de autenticação de checkout são visíveis para o navegador. O Cardflo fornece chaves públicas para inicialização do cliente, enquanto as chaves secretas do caixa permanecem na configuração protegida do servidor, fora dos modelos e do controlo de origem.
Implementação de rotação de chaves de caixa
Uma chave de caixa de produção pode exigir rotação programada após mudanças de pessoal, exposição de repositório ou um prazo de política criptográfica interna, sem interromper as sessões de checkout ativas. O Cardflo suporta a substituição controlada de chaves, permitindo que as equipas de engenharia implementem o novo segredo, validem a criação de pagamentos e desativem a credencial anterior após a transição.
Separação de chaves de loja multi-marca
Uma organização que opera várias lojas de marca precisa de chaves de checkout separadas para que uma credencial de cliente exposta não possa ser reutilizada em domínios ou aplicações não relacionados. O Cardflo permite a alocação e rotação distintas de chaves por loja, enquanto as equipas financeiras e de segurança mantêm visibilidade central sobre quais credenciais públicas e de caixa permanecem ativas.
Chaves de checkout e chaves de caixa em números
Os padrões da indústria sugerem que descarregar a recolha de dados para componentes alojados através de chaves do lado do cliente pode reduzir o número de requisitos PCI aplicáveis em mais de 90 por cento.
As arquiteturas padronizadas baseadas em chaves geralmente permitem que os programadores implementem um fluxo de finalização de compra seguro básico em aproximadamente dois dias úteis de tempo de desenvolvimento.
Os gateways de pagamento profissionais exigem que 100 por cento dos pedidos do lado do servidor sejam autenticados através de uma chave privada para garantir a integridade do ciclo de vida da transação.
Metodologia: estes valores são intervalos meramente indicativos, retirados de dados publicados do setor e de grupos de comerciantes observados, não constituindo garantias. Os resultados reais dependem do seu perfil de risco, da combinação de cartões, da geografia e da sua configuração de adquirência, sendo confirmados apenas nos seus próprios termos de preços e aprovação.
Termos relacionados
Fale com a nossa equipa sobre uma implementação live nas rails dos nossos parceiros adquirentes.
O que obtém com Chaves de checkout e chaves de caixa
- Isolar as atividades do lado do cliente das funções administrativas sensíveis do backend para maior segurança
- Minimizar a exposição ao PCI DSS, garantindo que os dados brutos do cartão contornam os servidores do comerciante
- Autorizar componentes de pagamento de frontend usando credenciais de chave de checkout restritas e públicas
- Executar capturas e reembolsos seguros do lado do servidor com pedidos autenticados de chave de caixa
- Manter controlo de acesso granular sobre endpoints de API específicos e operações de transação
- Suportar uma ampla gama de frameworks de frontend sem arriscar a exposição de credenciais de backend
A short scoping call, then a written plan for your MIDs.
Perguntas sobre Chaves de checkout e chaves de caixa
Qual é a principal diferença entre uma chave de checkout e uma chave secreta de API?
Uma chave de checkout é projetada para uso em ambientes públicos onde o código é visível, como um navegador. Tem permissões extremamente limitadas, tipicamente apenas sendo capaz de criar um token de pagamento.
Uma chave secreta de API, ou chave de caixa, é usada para operações do lado do servidor e tem o poder de movimentar dinheiro, realizar reembolsos e aceder a dados sensíveis do comerciante.
Manter estas chaves separadas garante que, mesmo que uma chave pública seja copiada, as funções financeiras centrais da conta do comerciante permanecem protegidas por trás da autenticação do lado do servidor.
Uma chave de checkout pode ser usada para realizar um reembolso ou anular uma transação?
Não, as chaves de checkout são especificamente restritas para evitar quaisquer operações que envolvam a movimentação de fundos da conta do comerciante.
Reembolsos, anulações e capturas exigem o uso de uma chave de caixa, que deve ser mantida em segredo e usada apenas num ambiente de servidor seguro.
Esta salvaguarda é intencional e impede que atores maliciosos manipulem o código do lado do cliente para acionar reversões financeiras não autorizadas ou exportações de dados do gateway de pagamento.
Por que este sistema de duas chaves é necessário para a conformidade com o PCI DSS?
A conformidade com o PCI DSS foca-se em como os dados do titular do cartão são tratados.
Ao usar uma chave de checkout para facilitar a tokenização dos dados do cartão diretamente do navegador do cliente para o processador de pagamento, o comerciante nunca toca nos dados brutos. A chave de caixa permite então que o comerciante trabalhe com esse token.
Esta separação é o que permite a um comerciante usar questionários de conformidade simplificados, pois os seus sistemas nunca estão na posse de informações sensíveis como PANs em texto claro.
Como devem as chaves de caixa ser armazenadas na infraestrutura de um comerciante?
As chaves de caixa devem ser tratadas como credenciais altamente sensíveis. Nunca devem ser codificadas em ficheiros de origem ou armazenadas em sistemas de controlo de versão como o Git.
Em vez disso, devem ser geridas usando variáveis de ambiente ou um serviço dedicado de gestão de segredos.
O acesso a estas chaves deve ser restrito às instâncias de servidor específicas que as exigem para comunicar com o processador de pagamento para a finalização e relatórios de transações.
Funcionalidades relacionadas.
Relacionados guias.
Veja como a Cardflo compara.
Preparado para melhorar a sua configuração de pagamentos?
Fale-nos do seu negócio. Iremos apresentá-lo aos parceiros adquirentes e à rota certa, normalmente em menos de uma semana.