Guia de integração: MagenPay
Perfil: Administrador da Plataforma
Área: Adquirentes
Tutorial: como gerar sua chave API pública
Para integrar sua chave API, é necessário gerar duas chaves:
Chave privada (
priv.pem): deve permanecer guardada e nunca ser compartilhada.Chave pública (
pub.pem): esta é a chave que será copiada e cadastrada na plataforma.
Tutorial para Windows
1. Crie uma pasta para guardar as chaves
No Windows, crie uma pasta segura, por exemplo:
G:\Certificados PEM
Abra essa pasta, clique com o botão direito em uma área vazia e escolha “Abrir no Terminal”.
2. Instale o OpenSSL
No PowerShell, execute:
winget install -e --id ShiningLight.OpenSSL.Light
Após finalizar a instalação, feche o PowerShell e abra-o novamente.
3. Localize o OpenSSL
Execute o comando abaixo:
Get-ChildItem "C:\Program Files" -Recurse -Filter openssl.exe -ErrorAction SilentlyContinue | Select-Object -ExpandProperty FullName
Copie o caminho exibido. Normalmente será semelhante a:
C:\Program Files\OpenSSL-Win64\bin\openssl.exe
4. Acesse a pasta onde as chaves serão criadas
No PowerShell, execute:
cd "G:\Certificados PEM"
5. Gere sua chave privada
Utilize o comando abaixo. Caso o caminho encontrado no passo 3 seja diferente, substitua-o no comando:
& "C:\Program Files\OpenSSL-Win64\bin\openssl.exe" ecparam -name secp256k1 -genkey -noout -out priv.pem
Isso criará o arquivo priv.pem.
6. Gere sua chave pública
Execute:
& "C:\Program Files\OpenSSL-Win64\bin\openssl.exe" ec -in priv.pem -pubout -out pub.pem
Isso criará o arquivo pub.pem.
7. Copie a chave pública para a plataforma
Abra o arquivo:
notepad pub.pem
Copie todo o conteúdo do arquivo, incluindo as linhas abaixo:
-----BEGIN PUBLIC KEY----- ... -----END PUBLIC KEY-----
Cole esse conteúdo no campo “Chave API Pública” da plataforma e avance para as próximas etapas.
Atenção
Nunca compartilhe o arquivo
priv.pem.Não envie a chave privada por WhatsApp, e-mail ou para outras pessoas.
Guarde a chave privada em local seguro, pois ela será necessária para autenticar as solicitações da integração.
Apenas o conteúdo de
pub.pemdeve ser informado na plataforma.
Tutorial para macOS
Este procedimento funciona em Macs com processador Intel e Apple Silicon.
1. Abra o Terminal e crie uma pasta segura
Abra o aplicativo Terminal (pressione Command + Espaço, pesquise por "Terminal" e pressione Enter). Em seguida, execute:
mkdir -p "$HOME/Certificados-PEM" cd "$HOME/Certificados-PEM"
A pasta será criada dentro da sua pasta de usuário e receberá os arquivos das chaves.
2. Confirme se o OpenSSL e a curva estão disponíveis
O macOS normalmente já inclui o OpenSSL. Verifique com:
openssl version openssl ecparam -list_curves | grep secp256k1
Se os dois comandos exibirem uma versão e a curva secp256k1, prossiga para o passo 3.
Caso o OpenSSL não seja encontrado ou a curva não seja exibida, instale o Homebrew seguindo as instruções em <https://brew.sh> e, depois, execute:
brew install openssl@3 export PATH="$(brew --prefix openssl@3)/bin:$PATH" openssl version
O último comando ajusta o PATH apenas para a janela atual do Terminal, para que ela use a versão instalada pelo Homebrew. Não é necessário alterar nenhuma configuração permanente do macOS.
3. Gere a chave privada
Ainda dentro da pasta Certificados-PEM, execute:
openssl ecparam -name secp256k1 -genkey -noout -out priv.pem
O arquivo priv.pem será criado. Restrinja o acesso a ele para que somente o seu usuário possa lê-lo:
chmod 600 priv.pem
4. Gere a chave pública
Execute:
openssl ec -in priv.pem -pubout -out pub.pem
O arquivo pub.pem será criado na mesma pasta.
5. Copie a chave pública para a plataforma
Copie o conteúdo completo da chave pública para a área de transferência:
pbcopy < pub.pem
Cole o conteúdo no campo “Chave API Pública” da plataforma. A chave deve incluir as linhas -----BEGIN PUBLIC KEY----- e -----END PUBLIC KEY-----.
6. Verifique os arquivos (opcional)
Antes de cadastrar a chave, você pode validar a chave privada com:
openssl ec -in priv.pem -check -noout
O resultado esperado é EC Key valid..
Para visualizar a chave pública sem alterar seu conteúdo, use:
cat pub.pem
Tutorial para Linux
Os passos abaixo se aplicam às distribuições Linux mais comuns. Os exemplos de instalação cobrem Ubuntu/Debian, Fedora/RHEL e Arch Linux.
1. Abra o terminal e crie uma pasta segura
Abra o terminal da sua distribuição e execute:
mkdir -p "$HOME/Certificados-PEM" cd "$HOME/Certificados-PEM"
2. Instale ou confirme o OpenSSL
Verifique se o OpenSSL já está instalado:
openssl version
Se o comando não for encontrado, instale-o de acordo com a sua distribuição:
Ubuntu, Debian, Linux Mint e derivados
sudo apt update sudo apt install openssl
Fedora, RHEL, Rocky Linux e derivados
sudo dnf install openssl
Arch Linux e derivados
sudo pacman -S openssl
3. Gere e proteja a chave privada
Dentro da pasta Certificados-PEM, execute:
openssl ecparam -name secp256k1 -genkey -noout -out priv.pem chmod 600 priv.pem
O arquivo priv.pem contém a chave privada. O comando chmod evita que outros usuários do computador possam lê-lo.
4. Gere a chave pública
Execute:
openssl ec -in priv.pem -pubout -out pub.pem
5. Copie a chave pública para a plataforma
Para exibir a chave e copiá-la manualmente, execute:
cat pub.pem
Copie todo o conteúdo, incluindo -----BEGIN PUBLIC KEY----- e -----END PUBLIC KEY-----, e cole-o no campo “Chave API Pública” da plataforma.
Em distribuições com uma ferramenta de área de transferência instalada, você também pode copiar diretamente:
# GNOME/KDE em Wayland (com wl-clipboard instalado) wl-copy < pub.pem # X11 (com xclip instalado) xclip -selection clipboard < pub.pem
6. Verifique a chave antes do cadastro (opcional)
openssl ec -in priv.pem -check -noout
O resultado esperado é EC Key valid..
Se receber um erro, apague somente os arquivos priv.pem e pub.pem dessa pasta e refaça a geração antes de cadastrar qualquer chave na plataforma.