Skip to main content

​
Criar uma chave de API

Chaves de API só podem ser criadas pelo painel, logado na sua conta:
1

Acesse Integrações → Chaves de API

No menu lateral, abra Integrações.
2

Escolha os escopos

Selecione até 3 escopos: pix:write, pix:read e/ou balance:read. Dê um nome para identificar onde a chave será usada (ex: “Loja - produção”).
3

Copie o secret imediatamente

O secret completo (formato zpk_live_...) só é exibido uma única vez, no momento da criação. Guarde-o em um cofre de segredos ou variável de ambiente — a ZynPay não consegue mostrá-lo de novo.

​
Usar a chave nas requisições

Envie a chave no cabeçalho Authorization, como um Bearer token:
Nunca exponha a chave no front-end do seu site ou app. Ela deve ficar apenas no seu backend.

​
Expiração e revogação

  • Você pode definir uma data de expiração opcional ao criar a chave.
  • Uma chave revogada para de funcionar imediatamente — use isso se ela vazar ou não for mais necessária.
  • Uma chave só funciona enquanto a conta estiver verificada; se a conta for suspensa, todas as chaves param de autenticar.