Doações

A nossa integração do APP Doações conecta a sua solução de pagamento Pagar.me com uma solução de doeações, que pode ajudar você e a sua instituição a receberem doações de maneira mais fácil e segura!
Com essa integração ajudamos você a gerar um checkout para as doações, podem configurar horários e abertura e fechamento da doação e até um redirecionamento em caso de sucesso!

Pré requisitos para a instalação
Para utilizar o Doações com a Pagar.me é necessário que alguns pré-requisitos sejam atendidos. Dentre eles o mais importante é:

Conta Pagar.me integrada na versão mais atual da nossa API (V5). Caso deseje criar uma conta no Pagar.me, cadastre-se clicando aqui;

Etapas da Integração

Configurações na Dash Pagar.me

O primeiro e único passo para realizar esta integração com sucesso é ter uma conta com o Pagar.me, ela pode ser criada aqui.
Após ter conectado no Pagar.me é necessário acessar a Dash da Pagar.me, pois será por ela que iremos configurar o checkout!

Primeiro iremos entrar nas configurações da sua Account na Dash Pagar.me, iremos entrar em "Funcionalidades" e é preciso habilitar o Checkout, existem algumas configurações adicionais que você poderá fazer, configure tudo e depois confirme a sua alteração!

Integração com o Hub

Agora para efetivarmos a nossa integração da Pagar.me com o Doações basta entrar no nosso Hub de aplicativos com a sua conta, clicar no APP Doações da categoria 'Plataforma' e clicar em "Integrar com Pagar.me".

Então seremos redirecionados para a configuração da nossa Integração;
Nesta etapa iremos configurar a nossa integração, as permissões que o APP precisa é apenas de criar um pedido e é uma permissão não opcional, mas temos outras configurações possíveis para o APP.

Campos

Habilitado: A página de doações somente irá funcionar se essa opção estiver ativa, então é importante deixar este campo habilitado caso queira que seu link funcione;
Pular redirecionamento para a página de sucesso: Se configurado, o sucesso na compra será exibido no próprio checkout, se não estiver habilitado o checkout redirecionará o usuário para o link configurado no campo 'Url de Sucesso';
Nome para a Url de Doações: O link será preenchido com o nome que for adicionado neste campo, pode ser o nome da sua instituição, um recado ou simplesmente uma palavra;
Url de Sucesso: Url para redirecionamento do checkout após o sucesso caso o campo 'Pular redirecionamento para a página de sucesso' esteja desabilitado;
Tempo de Expiração do Checkout (em minutos): Informa em quanto tempo o checkout deve expirar após a sua criação, caso o pagamento não seja finalizado;
Descrição do Item do Pedido: Por padrão, será exibido Doação no item do pedido na tela de Checkout, variando apenas o valor. Você pode customizar essa descrição escrevendo alguma mensagem ou para quem se destina essa doação, por exemplo;
Código padrão do Item do Pedido: Por padrão, enviaremos o código doacao no item do pedido. Em acordo com alguns provedores de anti-fraude, esse campo pode ser utilizado na identificação do tipo do pedido no provedor, então você poderá alterar o campo se desejar;
Data/Horário de início: Informa o dia/horário que as doações serão disponibilizadas, caso não informado, as doações serão iniciadas imediatamente;
Data/Horário de fechamento: Informa o dia/horário que as doações serão encerradas, caso não informado, as doações não serão encerradas automaticamente;
Valores: Aqui é possível configurar todos os valores aceitos e seus respectivos parcelamentos;
- Valor: Valor em Reais (valor inteiro). Ex. 5 para R$ 5,00;
- Máximo de Parcelas: Valor máximo de parcelas para esse valor. Ex. 1 parcela para o valor R$ 5,00;

É possível criar diversos valores para o seu link do Checkout, cada valor criado cria uma URL nova.

Após clicar em "Autorizar" a integração o seu link para o checkout de doações já irá funcionar!

Mas como funciona o link?

A URL é criada com o slug (campo "Nome para a Url de doações") e cada valor informado, é possível redirecionar o doador para a página específica de cada valor:
https://doacoes.pagar.me/{nome-da-loja}/doe-{valor}

Exemplo:
Nome para a Url de doações: doacao-legal
Valores: R$ 5 e R$ 50

URLs:
Para doar R$ 5 -> https://doacoes.pagar.me/doacao-legal/doe-5
Para doar R$ 50 -> https://doacoes.pagar.me/doacao-legal/doe-50

Integrei, e agora?

Após realizar a sua integração você poderá acessa-la na página do APP ou em "Minhas integrações".
Podendo editá-la ou excluí-la caso desejar.

Recebendo as doações

Após integrado o APP Doações o link já irá funcionar e você poderá receber doações pelo checkout configurado, você poderá ver a doação em sua Dash Pagar.me, em pedidos e em cobranças.

Dúvidas

Eai, ficou alguma dúvida sobre a nossa Integração com a solução de Doações?

Se você tiver dúvidas pode entrar em contato com o nosso suporte pelo e-mail
Nosso time ficará feliz em te ajudar com a instalação desse APP!