Credit top-ups
Credit top-ups
With Credit Top-Up, singers add credit from their phone, from the same page they use to put their name down for a song. They pay with PayPal or a card, and the money goes straight to your own PayPal or Stripe account. You pay PayPal's or Stripe's usual fees; QUP takes nothing and never holds the money.
The credit they buy is the same credit as always: it pays for songs and bribes at your venue, it shows in the singer's record, and you can change it there like any other credit.
What you need
- QUP Karaoke Engine 2.36.0 or newer.
- The Credit Top-Up plugin, a free download from the Plugin Browser (see below).
- A venue linked to QUP Cloud (Preferences → General → Cloud; see Cloud). Singers reach Add credit through the venue's phone page.
- One way to be paid, from the three below.
Three ways to be paid
Pick one per venue. You can change it any time.
| You need | Singers pay with | Credit is added | |
|---|---|---|---|
| PayPal checkout | A PayPal Business account | PayPal or a card, as PayPal offers them | As soon as PayPal confirms the payment |
| Stripe | A Stripe account | A card, Apple Pay or Google Pay | As soon as Stripe confirms the payment |
| PayPal.me link | A PayPal.me link | PayPal | When you approve it |
Getting the plugin
Credit Top-Up doesn't come with QUP; you add it when you want it.
- Open the Plugin Browser: in the Media Library, Plugins → General → Plugin Browser (see Plugin Manager).
- Find Credit Top-Up and tick it.
- Press Apply at the bottom, then restart QUP.
Setting it up
Open Preferences → Plugins → Credit Top-Up.
Packs
Set up to six packs: what the singer pays, and the credit they get, for example:
| Pay | Get |
|---|---|
| $5.00 | $5.00 |
| $10.00 | $11.00 |
| $20.00 | $23.00 |
A pack can be at most $100. Pick your currency once for the venue. A singer's credit can't go over $500, the same limit as at the bar.
PayPal checkout
- Sign in at developer.paypal.com with your PayPal Business account.
- Go to Apps & Credentials, and under Live, choose Create App (a Merchant app).
- Copy the app's Client ID and Secret.
- In QUP, choose PayPal checkout, set PayPal to Live, and paste the Client ID and the Secret.
- Test connection checks the keys with PayPal. It creates nothing and charges nothing.
- Save settings. Singers see Add credit on their phone within a few seconds.
To try it first without real money, use the keys from the Sandbox tab instead, with PayPal set to Sandbox, and pay with one of PayPal's sandbox test accounts.
Stripe
- In your Stripe Dashboard, go to Developers → API keys and choose Create restricted key.
- Give it only these permissions, and leave everything else at None:
- Checkout Sessions: Write
- PaymentIntents: Read
- Charges: Read
- Disputes: Read
- Copy the key (it starts
rk_live_). - In QUP, choose Stripe and paste the key.
- Test connection checks the key and tells you if a permission is missing. It creates nothing and charges nothing.
- Save settings.
QUP only takes a restricted key. A full secret key (sk_...) is refused: a restricted key can do only what the list above allows.
To try it first, make the restricted key in Stripe's test mode (it starts rk_test_) and pay with one of Stripe's test cards.
PayPal.me link
For a KJ without a PayPal Business account.
- Choose PayPal.me link and type your PayPal.me name (the part after
paypal.me/). - Save settings.
You are the only check. QUP never sees these payments. When a singer picks a pack, their phone shows the amount, a link to your PayPal.me page and a five-letter code to put in PayPal's note. QUP shows you who asked, for how much, and the code. Look for that payment and that code in your own PayPal app, then choose Approve to add the credit, or Not found if it isn't there. QUP adds whatever you approve.
A request you haven't approved after two hours expires. Read PayPal's terms on receiving payments with a personal account.
What singers see
On the venue's phone page, a signed-in singer sees Your credit with an Add credit button. They pick a pack, then:
- PayPal checkout: PayPal's own payment window opens on the phone. When they approve, the credit is added and the page shows their new credit.
- Stripe: Stripe's payment page opens. When they've paid, they come back to the venue's page and the credit is added.
- PayPal.me link: the page shows the amount, the code and an Open PayPal link, and tells them the credit is added when you confirm.
The price always comes from your packs in QUP. A phone can't change it.
Tonight's list
The settings page lists the last day's top-ups: the time, the singer, the pack, and whether it was Added, Not paid yet, Waiting for you, Not found or Expired, with PayPal's or Stripe's id for the payment so you can find it there.
Refunds
Refunds are made in PayPal or Stripe, as usual. QUP checks the last 30 days of top-ups, and when one has been refunded (or disputed), it tells you and shows it on the settings page with two choices:
- Remove credit takes the top-up's credit back from the singer. If they've already spent some, it takes what's left and stops at zero.
- Keep it leaves the credit as it is.
QUP never takes credit back on its own.
Turning it off
Choose Off and Save settings. Add credit disappears from the phones within a few seconds. Your records stay.
Updated on version 2.36.0, November 5, 2026