Skip to main content
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

EventFires when
paymentSuccessPayment completes
paymentFailedPayment 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.