Payment Widget

Category: Controls · Charges: users · Fires: paymentSuccess / paymentFailed

Mental model

A Payment Widget is a checkout button. It presents a paid action; when the user pays, it unlocks or triggers what it gates — turning a dashboard into a place you can earn.

When to use it

Charge for a premium action, unlock, or one-off operation
Monetize an action inside an otherwise free dashboard

Settings

General

Widget Title / ID
Action type — what the payment unlocks/does
Amount · currency · currency position
Button label · button variant
Command endpoint — the action invoked on success
Description

Style

Amount styling (color / size / weight), description styling, alignment, background, border. Error state: error icon / title / message.

Triggers

Event	Fires when
`paymentSuccess`	Payment completes
`paymentFailed`	Payment fails
(common)	`load`, `ready`, `destroy`, `update`, `visible`, `hidden`

Example — unlock on success

WHEN     paymentSuccess
SEND TO  Current Device
EXECUTE  Premium
Action   UNLOCK   params: {}

Payments feed your product’s earnings — see the monetization docs for the fee model and settlement.

Script API example

The same interactions from a dashboard script:

widget.on('unlockPay', 'paymentSuccess', () => widget.show('premiumPanel'));
widget.on('unlockPay', 'paymentFailed',  () => widget.setText('payStatus', 'Payment failed'));

Payment Widget (monetization)

The business side.

Revenue & fees

3% flat fee, 97% to you.

Designer

Widget Reference

Mental model

When to use it

Settings

General

Style

Triggers

Example — unlock on success

Script API example

Payment Widget (monetization)

Revenue & fees

​Mental model

​When to use it

​Settings

​General

​Style

​Triggers

​Example — unlock on success

​Related

​Script API example

Payment Widget (monetization)

Revenue & fees

Mental model

When to use it

Settings

General

Style

Triggers

Example — unlock on success

Related

Script API example