๐Ÿ’ธ PayUs-as-a-Service

May 30, 2026 ยท View on GitHub

Banner

๐Ÿ’ธ PayUs-as-a-Service

Node.js Express.js License

๐Ÿ“– Full Documentation | ๐Ÿš€ Getting Started | ๐Ÿ“š API Reference

Does it ever happen in your career or personal life that you need to collect money someone owes you? Are you shy, out of words, or don't know how to ask or what tone to use?

Should it be Professional, Friendly, Frank, Funny, or Playful?

This project will perfectly solve (I hope) the questions above.

About

PayUs-as-a-Service (PUaaS) is an API that returns randomized messages for past-due invoices โ€” perfectly suited for any scenario: personal, professional, dev life, or just your everyday life.

Built for thick-faced, ghost, and shameless clients.

GitAds Sponsored

Sponsored by GitAds

API Usage

Live API: https://puaas.sticknologic.is-a.dev

Interactive Documentation: https://puaas.sticknologic.is-a.dev/docs

Method: GET

Rate Limit: 60 requests per minute per IP

API Endpoints

MethodEndpointAuthDescriptionRate Limit
GET/payusNoGet a randomized message in random tone60/min
GET/payus/professionalNoGet random professional message60/min
GET/payus/frankNoGet random frank message60/min
GET/payus/friendlyNoGet random friendly message60/min
GET/payus/playfulNoGet random playful message60/min
GET/payus/funnyNoGet random funny message60/min
GET/payus/tonesNoGet available tones60/min

Setup

Requirements:

  • Node.js 22+

Install and run:

npm install
npm start

Run tests:

npm test

The server listens on http://localhost:3000 by default.

Environment

  • PORT changes the listen port.
  • RATE_LIMIT_PER_MINUTE changes the in-memory request limit per IP.

Response Shapes

Random message response:

{
  "message": "string",
  "tone": "Professional"
}

Tone list response:

{
  "success": true,
  "message": "Success",
  "data": {
    "tones": {
      "professional": "Professional",
      "playful": "Playful",
      "friendly": "Friendly",
      "frank": "Frank",
      "funny": "Funny"
    }
  }
}

Error response:

{
  "success": false,
  "message": "No messages found for the specified criteria."
}

Projects Using PayUs-as-a-Service

Here are some projects made by our BRAVE developers that integrate PayUs-as-a-Service to deliver their dismay, despair, and disappointment via past-due invoice messages:

  • Your Project Here? If you're using PayUs-as-a-Service in your project, open a pull request to be featured here!

Contributing

We welcome contributions! Here's how you can help:

Step 1: Fork the repository

Step 2: Create your feature branch

git checkout -b feature/amazing-feature

Step 3: Make your changes and test them

npm test

Step 4: Commit your changes

git commit -m 'Add amazing feature'

Step 5: Push to the branch

git push origin feature/amazing-feature

Step 6: Open a Pull Request

Ideas for Contributions

  • Add more message variations to messages.json
  • Improve documentation
  • Add new language translations
  • Fix bugs or improve performance
  • Add new API features or tone categories

Author

Created with a broken heart and torn wallet by STICKnoLOGIC

License

This project is open-sourced software licensed under the MIT license.