MakePay Bubble Plugin

Bubble plugin source for MakePay payment links, payment status lookup, customer creation, bookkeeping invoices, and signed webhook verification.

Bubble marketplace plugins are published through Bubble's plugin editor. This repository is the source package for that editor: it contains the server-side action code, client helper action, plugin blueprint, setup docs, local tests, and repository governance docs.

Features

• Create hosted MakePay payment links from Bubble workflows.
• Open hosted checkout from a Bubble page.
• Look up a MakePay payment link by UID.
• Create or update a MakePay customer.
• Create a bookkeeping invoice.
• Create a payment link for a bookkeeping invoice.
• Verify X-MakePay-Signature inside Bubble backend workflows.

Why Server-Side Actions

MakePay key secrets must stay off the browser. Bubble's plugin server-side actions and API Connector server processing are the right fit for creating payment links and verifying webhooks because credentials remain in Bubble's server runtime.

Plugin Settings

Create these shared plugin keys in Bubble's plugin editor:

Key	Private	Notes
MakePay Key ID	Yes	Merchant partner API key ID.
MakePay Key Secret	Yes	Merchant partner API key secret.
MakePay Webhook Secret	Yes	Secret used to verify webhook signatures.
MakePay Base URL	Yes	Defaults to https://www.makecrypto.io.

Actions

Action	Runtime	Source
Create payment link	Server-side	src/server-actions/create-payment-link.js
Get payment link	Server-side	src/server-actions/get-payment-link.js
Create customer	Server-side	src/server-actions/create-customer.js
Create bookkeeping invoice	Server-side	src/server-actions/create-bookkeeping-invoice.js
Create invoice payment link	Server-side	src/server-actions/create-invoice-payment-link.js
Verify webhook signature	Server-side	src/server-actions/verify-webhook-signature.js
Open checkout	Client-side	src/client-actions/open-checkout.js

See docs/SETUP.md for Bubble editor setup steps.

Development

npm test
npm run validate

The test suite uses Node's built-in test runner and stubs fetch; it does not call MakePay.

Security

Keep MakePay credentials in private plugin keys or private API Connector parameters. Do not place key secrets in page properties, exposed states, custom HTML, or client-side JavaScript.