gerencianet

Description:

gerencianet

Plugin Gerencianet Flutter



Plugin em Flutter para integração com a API da Gerencianet.
Ir para:

Instalação
Começando

Como obter as credenciais Client_Id e Client_Secret
Como gerar um certificado Pix
Como converter um certificado Pix
Como cadastrar as chaves Pix


Exemplos
Documentação Adicional
Licença

Instalação #
Para usar este plugin, adicione gerencianet como uma dependência em seu arquivo pubspec.yaml.
Começando #
Em seguida, inicialize o plugin de preferência no initState do seu widget.
...
import 'package:gerencianet/gerencianet.dart';

class _PaymentPageState extends State<PaymentPage> {
var config = {
'client_id': 'YOUR_CLIENT_ID',
'client_secret': 'YOU_CLIENT_SECRET',
'sandbox': false,
'pix_cert': '',
'pix_private_key': ''
};
Gerencianet gerencianet;

@override
void initState() {
this.gerencianet = Gerencianet(config);
}

}
...
copied to clipboard
Como obter as credenciais Client-Id e Client-Secret #
Crie uma nova aplicação para usar a API Gerencianet: #

Acesse o painel da Gerencianet no menu API.
No canto esquerdo, clique em Minhas Aplicações depois em Nova Aplicação.
Insira um nome para a aplicação, ative a API de emissões (Boletos e Carnês) e API Pix, e escolha os escopos que deseja liberar em Produção e/ou Homologação conforme sua necessidade (lembrando que estes podem ser alterados posteriormente).
Clique em Criar Nova aplicação.


Alterar uma aplicação existente para usar a API Pix: #

Acesse o painel da Gerencianet no menu API.
No canto esquerdo, clique em Minhas Aplicações, escolha a sua aplicação e clique no botão Editar (Botão laranja).
Ative API Pix e escolha os escopos que deseja liberar em Produção e/ou Homologação conforme sua necessidade (lembrando que estes podem ser alterados posteriormente)
Clique em Atualizar aplicação.


Como gerar um certificado Pix #
Todas as requisições do Pix devem conter um certificado de segurança que será fornecido pela Gerencianet dentro da sua conta, no formato PFX(.p12). Essa exigência está descrita na íntegra no manual de segurança do PIX.
Para gerar seu certificado:

Acesse o painel da Gerencianet no menu API.
No canto esquerdo, clique em Meus Certificados e escolha o ambiente em que deseja o certificado: Produção ou Homologação.
Clique em Novo Certificado.


Como converter um certificado Pix #
⚠️Para uso no Flutter, o certificado deve ser convertido em formato .pem e é necessário criar uma chave privada para o certificado.
Você pode baixar o conversor de certificados disponibilizado pela Gerencianet.
Ou utilize do exemplo abaixo, executando o comando OpenSSL para conversão.
Comando OpenSSL #
# Gerar certificado e chave separadas
openssl pkcs12 -in path.p12 -out newfile.crt.pem -clcerts -nokeys #certificado
openssl pkcs12 -in path.p12 -out newfile.key.pem -nocerts -nodes #chave privada
copied to clipboard
Como cadastrar as chaves Pix #
O cadastro das chaves Pix pode ser feito através do aplicativo da Gerencianet ou por um endpoint da API. A seguir você encontra os passos de como registrá-las.
Cadastrar chave Pix pelo aplicativo mobile: #
Caso ainda não tenha nosso aplicativo instalado, clique em Android ou iOS, de acordo com o sistema operacional do seu smartphone, para fazer o download.
Para registrar suas chaves Pix por meio do aplicativo:

Acesse sua conta através do app Gerencianet.
No menu lateral, toque em Pix para iniciar seu registro.
Leia as informações que aparecem na tela e clique em Registrar Chave.
Se este não for mais seu primeiro registro, toque em Minhas Chaves e depois no ícone (➕).
Selecione os dados que você vai cadastrar como Chave do Pix e toque em avançar – você deve escolher pelo menos 1 das 4 opções de chaves disponíveis (celular, e-mail, CPF e/ou chave aleatória).
Após cadastrar as chaves do Pix desejadas, clique em concluir.
Pronto! Suas chaves já estão cadastradas com a gente.

Exemplos #
Você pode consultar todos os exemplos disponiveis para Flutter, clicando aqui.
Também disponibilizamos um projeto em Flutter contendo exemplos de todas as funcionalidades das nossas APIs. Você pode clonar o repositório do projeto, clique aqui para acessar.
Documentação Adicional #
A documentação completa com todos os endpoints e detalhes da API está disponível emhttps://dev.gerencianet.com.br/.
Licença #
MIT