Guias
Make
Pagamentos em qualquer cenário do Make: gatilhos instantâneos para faturas pagas, reembolsos, assinaturas e clientes; módulos que criam e buscam faturas e links de pagamento.
O app do Perly Pay leva os seus pagamentos para o Make. Uma fatura paga pode preencher uma planilha, atualizar um CRM ou dar um cargo no Discord; um formulário pode criar uma fatura e enviar o checkout. Não há nada para hospedar nem código.
Conectar
- 1
Pegue uma chave
No Perly Pay: Dashboard → Developers → API keys.
sk_test_…para o modo de teste,sk_live_…para dinheiro real. - 2
Adicione o Perly Pay a um cenário
O app está a caminho da lista de apps do Make. Enquanto não aparece, escreva para nós para pedir o link de convite; abra-o uma vez e depois procure Perly Pay ao adicionar um módulo.
- 3
Conecte
Add uma conexão e cole a chave. Dê um nome que diferencie a de teste da de produção.
Gatilhos instantâneos
| Módulo | Quando | Evento |
|---|---|---|
| Watch paid invoices | Paga por inteiro, remetente verificado. É hora de liberar o acesso ou enviar o pedido. | invoice.fulfilled |
| Watch underpaid invoices | O comprador enviou menos do que a fatura pede. | invoice.underpaid |
| Watch opened refunds | Você abriu um reembolso. | refund.requested |
| Watch confirmed refunds | Um reembolso que você enviou foi confirmado na rede. | refund.confirmed |
| Watch started subscriptions | Uma assinatura começou. | subscription.created |
| Watch renewed subscriptions | Um assinante pagou o próximo período. | subscription.renewed |
| Watch ended subscriptions | Uma assinatura terminou. É hora de retirar o acesso. | subscription.ended |
| Watch new customers | Um comprador novo. | customer.created |
Quando você adiciona o webhook de um gatilho no Make, aparece em Dashboard → Developers → Webhooks um webhook como Make: Paid invoices; quando você o apaga no Make, ele some. Antes de o cenário rodar, o Make busca cada entrega no Perly Pay com a sua chave, e o Perly Pay entrega cada uma só uma vez: uma requisição que não vem do Perly Pay, ou enviada de novo, não executa nada. Cada webhook é um dos 16 que um modo pode ter.
Cada gatilho entrega o evento e o objeto a que ele se refere (fatura, reembolso, assinatura ou cliente) do jeito que a API os tem. Valores em moeda fiat vêm em centavos (total 4900 é 49.00): divida por 100 no mapeamento. Valores em cripto vêm na menor unidade da moeda, com os decimals ao lado.
Módulos
| Módulo | O que você informa | O que você recebe |
|---|---|---|
| Create an invoice | Um valor (como 49.00), uma descrição; se quiser, moeda, e-mail do cliente, endereço de retorno, metadados | Uma fatura com o checkout dela (Payment page URL) para o comprador |
| Create a payment link | Um preço, ou o nome e o valor de um produto novo | Uma página que o vende: compartilhe onde quiser |
| Get an invoice | O id da fatura | O status dela, o que chegou, o checkout |
| Search customers | Um e-mail, ou nada para todos | Clientes, os mais novos primeiro |
| Make an API call | Um caminho como /invoices, um método e um corpo JSON se precisar | A resposta da API como vem, para o que os outros módulos não fazem |
Receitas
Pagamento → linha no Google Sheets
- 1
Gatilho
Perly Pay → Watch paid invoices. Adicione um webhook; rode o cenário uma vez e pague uma fatura de teste para o Make aprender os campos.
- 2
Ação
Google Sheets → Add a Row, numa planilha com colunas como Data, E-mail, Valor, Moeda.
- 3
Mapeie
Data → Invoice: Paid at, E-mail → Customer email, Valor →
Total (cents) / 100, Moeda → Payment: Coin. Ative.
Pagamento → cargo no Discord
O Discord precisa saber quem pagou. Coloque o id do Discord do comprador na fatura ao criá-la e leia de volta quando ela for paga.
- 1
Cenário 1: a fatura
Gatilho: o seu formulário de cadastro com e-mail e id do Discord. Perly Pay → Create an invoice, chave de metadados
discord_user_id, valor: a resposta do formulário. Depois envie ao comprador a Payment page URL. - 2
Cenário 2: o cargo
Perly Pay → Watch paid invoices. Discord → Add a Role to a Member (ou Make an API call para o Discord): o seu servidor, o cargo, e o membro = Invoice: Metadata →
discord_user_id. - 3
Retire o cargo
Para uma assinatura, Watch ended subscriptions retira o cargo do mesmo jeito.
Teste
Com a conexão de teste, crie uma fatura (com o módulo ou no painel) e pague com moedas de teste ou pela API com o id da fatura:
Em alguns segundos o cenário roda. O History dele mostra cada execução e o que chegou.
Pagamentos reais
- Ative a produção no Perly Pay e conecte as chaves públicas da sua carteira.
- Adicione uma conexão com uma chave
sk_live_…. Em cada cenário, adicione nela um webhook novo para o gatilho e mude para ela os outros módulos do Perly Pay. - Pague uma fatura real pequena e veja como ela chega.