What is shoppepay-api-gateway?

This project is an unofficial API gateway that helps online store owners accept and automatically verify ShopeePay payments. ShopeePay is a mobile payment method in Indonesia. The README is explicit that this tool is not affiliated with or endorsed by Shopee in any way. Instead of using an official payment API, it works by reading data from the ShopeePay Partner Portal using the merchant's own account session token, similar to how a browser extension or automation script might operate. The gateway is built to require no database at all, storing everything it needs temporarily in server memory instead. This is meant to make it easy to run on free or low-cost cloud hosting that restarts often, since there is no persistent data to lose. When a customer wants to pay, the gateway can generate a dynamic QR code (a QRIS code, a standard used in Indonesia) with the exact amount owed, then poll ShopeePay's servers every ten to fifteen seconds to check whether that payment has arrived, but only while a customer is actively on the checkout page. This selective polling is meant to avoid triggering Shopee's own rate limits during quiet periods. Other stated features include support for multiple merchant accounts through different tokens, automatic detection of which payment app a customer used to send money, a background check every five minutes that alerts the store owner over Telegram if their access token has stopped working, and safeguards against two different customers accidentally being credited for the same payment when their amounts happen to match. Setup involves manually retrieving an internal ShopeePay token from the browser's developer tools while logged into the Partner Portal, then placing it along with an API key, a server port, and optional Telegram bot credentials into a configuration file. The README states plainly that using this tool in a commercial production environment is the user's own responsibility and depends on understanding ShopeePay's terms of service in their country. The project is marked as proprietary rather than open source.