STEP 1 — Install the plugin Install Billplz Payment Gateway from the Bubble marketplace.

STEP 2 — Get your Billplz credentials
- Sign up at billplz.com (or billplz-sandbox.com for testing)
- Go to Settings → Keys & Integration
- Copy your Billplz Secret Key
- Copy your X Signature Key
- Note your Collection ID from the Collections page

STEP 3 — Configure plugin settings
In your Bubble app, go to Plugins → Billplz Payment Gateway and enter:
- api_secret_key: Your Billplz Secret Key
- x_signature_key: Your X Signature Key
- mode: "sandbox" for testing, "production" for live payments

STEP 4 — Create a payment
Add the "Create Bill" action to any workflow with:
- collection_id: Your Billplz Collection ID
- email: Customer email
- name: Customer name
- amount: Amount in cents (RM10 = 1000)
- description: Payment description
- callback_url: Your backend workflow URL
- redirect_url: Your thank-you page URL

STEP 5 — Handle the redirect
On your thank-you page, run "Verify Redirect" on page load using URL parameters:
- bill_id: URL parameter "billplz[id]"
- paid: URL parameter "billplz[paid]"
- paid_at: URL parameter "billplz[paid_at]"
- x_signature: URL parameter "billplz[x_signature]"
Check is_valid = "true" and paid = "true" before updating your database.

STEP 6 — Handle callbacks
Create a backend API workflow exposed as a public endpoint.
Use "Verify X-Signature" to validate Billplz's POST before updating payment status.

Demo app editor link: https://bubble.io/page?name=billplz-demo&id=admin-da&tab=tabs-1