Download the PHP package paybeehive/beehivehub-php-sdk without Composer
On this page you can find all versions of the php package paybeehive/beehivehub-php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download paybeehive/beehivehub-php-sdk
More information about paybeehive/beehivehub-php-sdk
Files in paybeehive/beehivehub-php-sdk
Package beehivehub-php-sdk
Short Description PHP SDK for BeehiveHub API
License MIT
Informations about the package beehivehub-php-sdk
Beehive Hub PHP SDK
SDK oficial para integração com a API Beehive Hub. Aceite pagamentos de forma simples e rápida.
Índice
- Instalação
- Quick Start
- Autenticação
- Recursos
- Transactions
- Customers
- Transfers
- Balance
- Recipients
- Bank Accounts
- Company
- Payment Links
- Tratamento de Erros
- Valores em Centavos
- Boas Práticas de Segurança
- Desenvolvimento
- Suporte
- Licença
Instalação
Requisitos: PHP 8.2+, extensões curl e json.
Quick Start
Autenticação
O SDK usa Basic Authentication. Forneça sua SECRET_KEY ao instanciar o cliente.
Obtendo suas credenciais
- Acesse o dashboard Beehive Hub
- Navegue em Configurações → Credenciais de API
- Copie sua SECRET_KEY
Ambiente Sandbox
Importante: Nunca exponha sua secret key em código client-side ou repositórios públicos. Use variáveis de ambiente:
Recursos
Transactions
Criar uma transação
Listar transações
Buscar uma transação
Estornar uma transação
Atualizar status de entrega
Customers
Criar um cliente
Listar clientes
O parâmetro email é obrigatório pela API.
Buscar um cliente
Transfers
Criar uma transferência
Buscar uma transferência
Balance
Recipients
Criar um recipient
Listar recipients
Buscar um recipient
Atualizar um recipient
Bank Accounts
Adicionar conta bancária
Listar contas bancárias
Company
Buscar dados da empresa
Atualizar dados da empresa
Payment Links
O SDK adiciona url às respostas (create, get, list, update) quando há alias:
- Produção:
https://link.conta.paybeehive.com.br/{alias} - Sandbox:
https://link.sandbox.hopysplit.com.br/{alias}
Criar um link de pagamento
Se alias não for informado, o SDK gera automaticamente um código alfanumérico de 10 caracteres.
Listar links de pagamento
Buscar um link de pagamento
Atualizar um link de pagamento
Aceita atualizações parciais (apenas os campos que deseja alterar).
Deletar um link de pagamento
Tratamento de Erros
O SDK lança exceções específicas para cada cenário:
| Exceção | HTTP | Descrição |
|---|---|---|
BeehiveHubAuthenticationError |
401 | Chave de API inválida |
BeehiveHubValidationError |
400 | Erro de validação dos dados |
BeehiveHubNotFoundError |
404 | Recurso não encontrado |
BeehiveHubRateLimitError |
429 | Limite de requisições excedido |
BeehiveHubAPIError |
outros | Erros gerais da API |
BeehiveHubNetworkError |
— | Erro de rede/conexão |
Valores em Centavos
Todos os valores monetários na API são expressos em centavos.
Boas Práticas de Segurança
- Nunca exponha sua SECRET_KEY — use variáveis de ambiente
- Valide os dados do usuário antes de enviar para a API
- Use HTTPS em todas as conexões
- Implemente webhooks para receber notificações de mudança de status
Desenvolvimento
Rodando os testes
Cobertura de código
Requer a extensão PCOV ou Xdebug instalada no PHP.
Documentação Adicional
Suporte
Para sugestões, bugs ou dúvidas:
- E-mail: [email protected]
- Documentação: docs.beehivehub.io
Licença
Este projeto está licenciado sob a Licença MIT — veja o arquivo LICENSE para detalhes.
All versions of beehivehub-php-sdk with dependencies
ext-curl Version *
ext-json Version *