Integração com o Pagar.me
O Pagarme é o serviço de integração utilizado para efuatuar e gerencair todas as transações da plataforma. Este serviço é de configuração obrigatória para o correto funcionamento da sua plataforma.
No momento o Pagar.me é o único gateway de integração suportado.
Mais informação podem ser obtidas através dos portais oficiais do Pagar.me
Criar um Conta
Através do site do Pagar.me siga os passos necessários para criar sua conta.
Login na Plataforma
Atualmente o Pagar.me possui 2 tipos de sistemas na plataforma é suportado o Pagar.me 1.0 de acordo com a imagem abaixo.
O seu ambiente do Pagar.me 1.0 é divido em 2 tipos:
- Ambiente Live / Produção: Utilizado para transações reais que geram cobranças e debitos.
- Ambiente de Testes: Utilzado para transações de teste, quando não se quer que efetivamente exista transações de dinheiro.
Integração via API
Para transacionar com o Pagar.me você tem acesso a duas Chaves de API distintas, uma para teste e outra para produção (live). A chave do ambiente de produção contém o prefixo ak_live enquanto a chave de testes contém o prefixo ak_test.
Dica para Desenvolvedores
O endpoint é o mesmo, sendo possível diferenciar o ambiente apenas escolhendo a chave apropriada para o tipo de operação que você deseja fazer.
Danger
As chaves de autenticação para o ambiente live tem o poder de executar qualquer operação em nossa API, então é extremamente importante que você as mantenha em local seguro, e que não as compartilhe com qualquer pessoa.
Além disso é necessário configurar no Pagar.me a versão da API (protocolo) a qual é utilizada para se cominicar com o Pagar.me. Atualmente é suportada somente a API Versão 4 (2019-09-01).
A versão da API pode ser configurada no Pagar.me dentro da sua área do usuário no menu de Configurações na seção Chaves de API.
Configuração da Integração com a Plataforma
As configurações do Pagar.me da sua plataforma podem ser encontradas no painel administrativo dentro do menu Configurações da Plataforma na seção Pagarme. Todos os campos de configurações do pagarme são obrigatórios
API Key e Encryption Key
Os campos de API Key e Encryption Key devem ser obtidos dentro da sua área do usuário no Pagar.me no menu de Configurações na seção Chaves de API.
Taxa de Juros & Nº de parcelas sem juros
Nº de parcelas sem juros: Número de parcelas aonde não será cobrado a juros do aluno
Taxa de Juros: Define a taxa de juros a ser cobarda em caso de pagamentos em um número de parcelas superior a cofiguração Nº de parcelas sem juros.
URL de Recorrências & Transações
No momento apenas forneça os seguintes dados que seguem o informado pelo Pagar.me em sua documentação
URL de Recorrências: https://api.pagar.me/1/subscriptions
URL de Transações: https://api.pagar.me/1/transactions
Dica para Desenvolvedores
A documentação da API do Pagar.me utilizada como referencia está disponível em: https://docs.pagar.me/v4/reference