Set up Paisaify for UPI

WordPress and WooCommerce

No server to run. The plugin does everything inside your site.

1. In WordPress open Plugins, Add New, Upload Plugin. Choose paisaify-wp-plugin.zip, press Install Now, then Activate.
2. Open Paisaify, Settings. Fill in Your UPI ID and Payee name, tick Enable, and press Save. You will see a small "Saved" message at the bottom.
3. Shop checkout: open WooCommerce, Settings, Payments and switch on Paisaify for UPI (zero fee).
4. Donations: in Paisaify, Settings, Donations choose Take donations: Yes, then put [paisaify_donate] on any page. Skip this step if you do not take donations.
5. Connect the phone that receives your bank SMS (next section).
6. Test with a small order or a ₹1 payment link from Paisaify, Transactions, New payment link. Pay it from a UPI app and watch it turn Paid.
7. Optional: switch on alerts in Paisaify, Settings (ntfy and Telegram are free). Each group has step-by-step help.

Any other website

A small server (Node.js) watches your bank SMS and tells your site when a payment arrives. You set it up once and it can serve many sites.

1. Get a place to run it

You need Node.js 22.13 or newer (24 is best), a folder that is kept between restarts, and a https address. Pick any host below. The upload steps differ a little, and the settings are the same everywhere.

[Unit]
Description=Paisaify
After=network.target
[Service]
WorkingDirectory=/opt/paisaify
ExecStart=/usr/bin/node server.js
Restart=always
Environment=PORT=4900
[Install]
WantedBy=multi-user.target

pay.yourshop.com {
  reverse_proxy localhost:4900
}

2. Upload and start

1. Upload paisaify-core-deploy.zip to the host. On Hostinger: Websites, Add website, Node.js Apps, upload the zip, choose Node 22 or 24, and set the entry file to server.js.
2. Add the settings below as environment variables in the host's panel.
3. Deploy. Open your-address/admin and sign in with your ADMIN_TOKEN. If you see the dashboard, the server works.

Everything else is optional. Donations, email, alerts and WhatsApp are set later from the dashboard, with no file editing.

3. Activate with your key

Open your-address/admin, sign in with your ADMIN_TOKEN, and you will see Activate your copy. Paste the key that came with your purchase (it looks like PSFY-XXXX-XXXX-XXXX-XXXX) and press Activate. One key works on one installation. Without activation the dashboard stays locked, and after 7 days payments stop too.

4. Put the pay box on your site

Selling one thing from a static site (the price always comes from your server, so nobody can change it in the browser):

const r = await fetch('https://pay.yourshop.com/api/checkout', {
  method: 'POST', headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ product: 'report', consent: true, fields: { name, email, phone } }),
});
const { ok, html, error } = await r.json(); // html is the pay box. Show it on your page.

Donations (add your site to ALLOWED_ORIGINS and switch on donations in Settings):

<div data-paisaify-donate data-api="https://pay.yourshop.com/api"></div>
<script src="https://pay.yourshop.com/assets/donate.js" defer></script>

A shop that has its own server can create payments with the API. See the API section below.

5. Connect the phone, set alerts, test

Use the next sections. Then make a ₹1 payment link from Transactions, New payment link, pay it, and watch it turn Paid.

Connect your phone

Your phone is the eye of the system. It sees the "money received" text from your bank and tells the server. Use the phone that receives your bank SMS and keep it on with signal.

Alerts and receipts

All optional. Each one is free to start, and each has step-by-step help with links inside Settings.

Alerts carry only the amount and a reference number, never a customer's name, phone or email.

For developers: the API

Create a payment from your own server and get told when it is paid.

Add MERCHANT_API_KEY to the server settings, then:

curl -X POST https://pay.yourshop.com/api/v1/payments \
  -H "Authorization: Bearer $MERCHANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"amount":"999","reference":"ORD-1042","callback_url":"https://yourshop.com/hooks/upi","return_url":"https://yourshop.com/thanks"}'

Send the customer to the pay_url in the reply. The amount can be up to 99 paise above what you asked, which is how two orders of the same price stay apart. When paid, your callback_url receives a signed message. The full details are in the README inside the zip.

If something is not working

Good to know

• Money goes straight from the customer to your bank. Paisaify never holds it and never sees UPI PINs, cards or bank logins.
• It is not a payment gateway. It confirms a payment by reading your bank's credit SMS, so it needs the connected phone to stay on.
• UPI limits still apply, usually ₹1,00,000 per payment.
• Keep the dashboard private. Your ADMIN_TOKEN opens it.
• Your key is checked once a day. Flying Star sees only the key, your domain and the app version. Never a payment, a customer or a bank detail.