Tutorial de Instalação - Sistema de Link Pix

1. Requisitos

• PHP 7.4 ou superior
• Extensão PHP cURL habilitada para usar MedusaPay ou Beehive
• MySQL ou MariaDB
• Apache, Nginx, XAMPP, WAMP, Laragon ou hospedagem com PHP
• phpMyAdmin ou acesso ao MySQL

2. Enviar os arquivos

Envie todos os arquivos para a pasta do seu servidor, por exemplo:

public_html/gerapix

3. Criar o banco de dados

No phpMyAdmin, importe o arquivo banco.sql. Ele cria as tabelas necessárias e o usuário inicial.

4. Configurar conexão MySQL

Edite o arquivo config.php e ajuste:

$db_host = "localhost";
$db_name = "pix_links";
$db_user = "USUARIO_MYSQL";
$db_pass = "SENHA_MYSQL";

5. Configurar a URL do sistema

No arquivo config.php, altere a URL base:

define("BASE_URL", "https://seudominio.com/gerapix");

Essa URL também será usada como postback da MedusaPay em /postback_medusa.php e da Beehive em /postback_beehive.php.

6. Acessar o painel

Acesse:

https://seudominio.com/gerapix/login.php

Login inicial:

Usuário: admin
Senha: 123456

7. Configurar Pix manual, MedusaPay ou Beehive

No painel, clique em Configurações. Em Forma de geração do Pix, escolha:

• Pix manual: usa chave Pix, beneficiário, cidade e TXID para gerar Pix estático no próprio sistema.
• MedusaPay: usa a API da MedusaPay para criar a transação Pix e retornar o Pix Copia e Cola.
• Beehive: usa a API da Beehive para criar a transação Pix e retornar o Pix Copia e Cola.

8. Credenciais

Na seção MedusaPay ou Beehive, informe a Secret Key, nome, e-mail, telefone padrão do cliente, documento CPF/CNPJ se necessário e tempo de expiração do Pix.

A Beehive utiliza autenticação Basic no formato SECRET_KEY:x convertido em Base64.

9. Gerar link de pagamento

1. Digite o valor na tela inicial.
2. Clique em Gerar link.
3. O sistema vai gerar o link conforme a opção selecionada: Pix manual, MedusaPay ou Beehive.
4. O link aparece na lista com etiqueta do gateway usado.
5. Use 📋 para copiar ou 🔗 para visualizar.

10. Postbacks

Quando o gateway enviar atualização da transação, o arquivo correspondente atualiza o status salvo no banco:

https://seudominio.com/gerapix/postback_medusa.php
https://seudominio.com/gerapix/postback_beehive.php

Para funcionar, sua URL precisa estar pública e acessível pelo gateway.