Como Gerar as chaves de API no APP iPag

Nesta documentação vamos mostrar como localizar as chaves de API da iPag dentro do painel administrativo da plataforma.

Essas chaves são utilizadas para realizar integrações com sistemas externos, como lojas virtuais, ERPs ou aplicativos que precisam enviar e consultar informações de pagamento.

Pré-requisitos

Antes de iniciar, é necessário:

• Possuir uma conta ativa na iPag

• Ter acesso ao painel administrativo da iPag

• Possuir permissão para visualizar credenciais de API

Passo a passo em Vídeo:

Passo a passo Texto:

1. Acessar o painel da iPag

Primeiro, acesse o painel da iPag através do link:

https://app.ipag.com.br

Em seguida:

1. Informe seu usuário

2. Informe sua senha

3. Clique em Entrar

2. Acessar o menu de Aplicativos

Após realizar o login no painel:

1. No canto superior direito, clique na imagem de sua conta.

Essa área reúne algumas configurações da sua conta

3. Localizar o aplicativo de API

Dentro do campo aberto, clique em Credenciais de integração:

1. Procure pelo botão Renovar chave de API

2. Clique sobre o botão para renovar as chaves

3. Copie a chave gerada
4. Clique em confirmar

Onde utilizar essas chaves

A Chave de integração da iPag (API Key) é uma credencial que permite que a loja virtual se conecte com a plataforma de pagamentos da iPag.

Como integrar na Loja as chaves

Acesse o painel admin Magento 1 > no menu selecione Sistema > Configurações > Formas de pagamento > Módulo Ipag

Cartão de crédito (IPag)

Habilitado: Sim
Ambiente: Loja
Tipo de Transação: Online
Mensagem de confirmação de compra nas transações híbridas: Texto de sua preferência
Tipo de Cartão de Crédito: Selecione os cartões de crédito habilitados para serem utilizados nas compras de sua loja
New order status: Aguardando pagamento
Enviar email ao finalizar o pedido?: Sim
Título: Titulo exibido no método de pagamento. Exemplo (Cartão de crédito)
Código/Login no IPag: Seu e-mail para acessar o painel Ipag
API key IPag: Chave API gerada anteriormente no painel da Ipag
Número Máximo de Parcelas: Quantidade de parcelas disponível em sua loja
Valor mínimo de cada parcela: Valor mínimo de cada parcela
Taxa de Juros (%): Porcentagem de juros que será acrescida a cada parcela
Número de parcelas sem juros: Quantidade de parcelas que não terá juros
Oferecer desconto para pagamento à vista?: Sim/Não
Defina aqui o desconto à vista (em %): Inserir porcentagem de desconto para pagamentos no crédito à vista
Número Máximo de Parcelas para Cartões Visa, Cartões Mastercard, Cartões American Express...: Inserir a mesma quantidade de parcelas mencionada no campo Número Máximo de Parcelas.
Gera fatura para transações aprovadas: somente capturadas.
Payment from applicable countries: Todos os Países ou selecionar um país em específico
Valor Mínimo do Pedido: Valor mínimo que o pedido deve conter para que a opção de cartão seja exibida.
Valor Máximo do Pedido: Valor máximo que o pedido pode conter para que a opção de cartão seja exibida.
Usar Sandbox IPag: Sim, caso sejam chaves Sandbox, Não caso seja chaves produção
Verificar retorno das transações no IPag: Sim
Cancelar Automáticamente: Sim
Valor padrão para conversão: Insira apenas se não utilizará Real (R$)
Ativar compra por 1 clique: Sim/ Não
Exibir campo CVV para cartões armazenados: Sim/Não
Atributo para bloquear parcelamento: Caso deseje bloquear o parcelamento quando determinado produto estiver no carrinho, crie um atributo do tipo boolean (YES/NO) e preencha este campo com o código deste atributo. Em seguida, ative este atributo em todos os produtos que deseja receber somente à vista.
Recuperar documento do cliente do endereço?: Sim/Não
Código do campo customizado: Caso tenha habilitado a opção acima, preencha neste campo o código do campo customizado para recuperar o documento do cliente.

Pix (IPag)

Habilitado: Sim/Não
Título: Titulo exibido no método de pagamento. Exemplo (Pix)
Pix: Pix
New order status: Aguardando pagamento
Código/Login no IPag: Seu e-mail para acessar o painel Ipag
Enviar email ao finalizar o pedido?: Sim/ Não
Texto Personalizado: Texto de instrução (Ex:"Após a confirmação do pedido, você será redirecionado para a página de visualização do QR Code Pix.")
Gerar fatura automática para pix pagos: Sim/Não (Recomendado deixar Sim)
Status para pix faturados automaticamente: Pagamento confirmado
Payment from applicable countries: Todos os países ou selecionar um país em específico
Valor Mínimo do Pedido: Valor mínimo que o pedido deve conter para que a opção de cartão seja exibida.
Valor Máximo do Pedido: Valor máximo que o pedido pode conter para que a opção de cartão seja exibida.
Usar Sandbox IPag: Sim, caso sejam chaves Sandbox, Não, caso sejam chaves de produção.

Observações importantes

• Nunca compartilhe suas chaves de API publicamente

• Essas chaves funcionam como uma credencial de acesso à sua conta

• Caso suspeite de uso indevido, gere novas chaves no painel da iPag