Guías
Make
Pagos en cualquier escenario de Make: disparadores instantáneos para facturas pagadas, reembolsos, suscripciones y clientes; módulos que crean y buscan facturas y enlaces de pago.
La app de Perly Pay lleva tus pagos a Make. Una factura pagada puede rellenar una hoja, actualizar un CRM o dar un rol en Discord; un formulario puede crear una factura y enviar la página de pago. No hay nada que alojar ni código.
Conectar
- 1
Obtén una clave
En Perly Pay: Dashboard → Developers → API keys.
sk_test_…para el modo de prueba,sk_live_…para dinero real. - 2
Añade Perly Pay a un escenario
La app está en camino a la lista de apps de Make. Mientras no aparezca, escríbenos para pedir el enlace de invitación; ábrelo una vez y luego busca Perly Pay al añadir un módulo.
- 3
Conecta
Add una conexión y pega la clave. Ponle un nombre que distinga la de prueba de la real.
Disparadores instantáneos
| Módulo | Cuándo | Evento |
|---|---|---|
| Watch paid invoices | Pagada por completo, remitente revisado. Es momento de dar acceso o enviar el pedido. | invoice.fulfilled |
| Watch underpaid invoices | El comprador envió menos de lo que pide la factura. | invoice.underpaid |
| Watch opened refunds | Abriste un reembolso. | refund.requested |
| Watch confirmed refunds | Un reembolso que enviaste se confirmó en la red. | refund.confirmed |
| Watch started subscriptions | Empezó una suscripción. | subscription.created |
| Watch renewed subscriptions | Un suscriptor pagó el siguiente periodo. | subscription.renewed |
| Watch ended subscriptions | Una suscripción terminó. Es momento de quitar el acceso. | subscription.ended |
| Watch new customers | Un comprador nuevo. | customer.created |
Cuando añades el webhook de un disparador en Make, aparece en Dashboard → Developers → Webhooks un webhook como Make: Paid invoices; cuando lo borras en Make, desaparece. Antes de que el escenario se ejecute, Make recoge cada entrega en Perly Pay con tu clave, y Perly Pay entrega cada una una sola vez: una solicitud que no venga de Perly Pay, o que se envíe otra vez, no ejecuta nada. Cada webhook es uno de los 16 que puede tener un modo.
Cada disparador entrega el evento y el objeto al que se refiere (factura, reembolso, suscripción o cliente) tal como los tiene la API. Los importes en moneda fiat van en centavos (total 4900 es 49.00): divide entre 100 en el mapeo. Los importes en monedas cripto van en la unidad más pequeña de la moneda, con sus decimals al lado.
Módulos
| Módulo | Qué das | Qué obtienes |
|---|---|---|
| Create an invoice | Un importe (como 49.00), una descripción; si quieres, moneda, correo del cliente, dirección de retorno, metadatos | Una factura con su página de pago (Payment page URL) para el comprador |
| Create a payment link | Un precio, o el nombre y el importe de un producto nuevo | Una página que lo vende: compártela donde quieras |
| Get an invoice | El id de la factura | Su estado, lo que llegó, la página de pago |
| Search customers | Un correo, o nada para todos | Clientes, los más nuevos primero |
| Make an API call | Una ruta como /invoices, un método y un cuerpo JSON si hace falta | La respuesta de la API tal cual, para lo que no hacen los otros módulos |
Recetas
Pago → fila en Google Sheets
- 1
Disparador
Perly Pay → Watch paid invoices. Añade un webhook; ejecuta el escenario una vez y paga una factura de prueba para que Make aprenda los campos.
- 2
Acción
Google Sheets → Add a Row, en una hoja con columnas como Fecha, Correo, Importe, Moneda.
- 3
Mapea
Fecha → Invoice: Paid at, Correo → Customer email, Importe →
Total (cents) / 100, Moneda → Payment: Coin. Actívalo.
Pago → rol en Discord
Discord tiene que saber quién pagó. Pon el id de Discord del comprador en la factura al crearla y léelo de vuelta cuando se pague.
- 1
Escenario 1: la factura
Disparador: tu formulario de registro con correo e id de Discord. Perly Pay → Create an invoice, clave de metadatos
discord_user_id, valor: la respuesta del formulario. Luego envía al comprador la Payment page URL. - 2
Escenario 2: el rol
Perly Pay → Watch paid invoices. Discord → Add a Role to a Member (o Make an API call a Discord): tu servidor, el rol, y el miembro = Invoice: Metadata →
discord_user_id. - 3
Quita el rol
Para una suscripción, Watch ended subscriptions quita el rol de la misma forma.
Pruébalo
Con la conexión de prueba, crea una factura (con el módulo o en el panel) y págala con monedas de prueba o por la API con el id de la factura:
En unos segundos se ejecuta el escenario. Su History muestra cada ejecución y lo que llegó.
Pagos reales
- Activa el modo real en Perly Pay y conecta las claves públicas de tu billetera.
- Añade una conexión con una clave
sk_live_…. En cada escenario, añade en ella un webhook nuevo para el disparador y cambia a ella los demás módulos de Perly Pay. - Paga una factura real pequeña y mira cómo llega.