WSXPay

# WebShopX-Payments: Payment Plugin for WebShopX (https://camo.githubusercontent.com/0fde08834d6cdca7409ed47c4dbd37b994191ed7dea45005bd612684c5c90a08/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4a6176612d31375f2d2d5f32352d626c75653f7374796c653d666c61742d737175617265266c6f676f3d6f70656e6a646b266c6f676f436f6c6f723d7768697465)](https://github.com/Prism-Committee/WebShopX-Issues#) (https://camo.githubusercontent.com/b44782a938f66b00a6a0d386bfaf4e50012ca2b9a070c02ee06551ff82b6f464/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f50617065722d312e31382e322532422d6379616e3f7374796c653d666c61742d737175617265)](https://github.com/Prism-Committee/WebShopX-Issues#) (https://camo.githubusercontent.com/23ef3e358825df1117f62be6452dede872a800b2e4b502f997ddc7efb6541963/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f466f6c69612d312e31392e342532422d707572706c653f7374796c653d666c61742d737175617265)](https://github.com/Prism-Committee/WebShopX-Issues#) > WebShopX-Payments bridges real-world payment gateways with WebShopX. ## Quick Links (https://img.shields.io/badge/Official_Wiki-Docusaurus-34d058?style=for-the-badge&logo=docusaurus&logoColor=white)](https://docs.akihito.dpdns.org/category/webshopx-payments) (https://img.shields.io/badge/GitHub-WebShopX--Payments-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/Prism-Committee/WebShopX-Payments) --- ## Key Features `WebShopX-Payments` (also known as `WSXPay`) serves as the payment provider (underlying service provider) plugin for `WebShopX`. It seamlessly connects real-world currency payments with Minecraft servers running WebShopX. - **WebShopX**: Handles core business logic, including player account balances, top-up order management, product display, purchasing logic, redeem codes, and delivery (player claiming / execution of recharge commands). - **WebShopX-Payments**: Focuses exclusively on the payment pipeline. This includes requesting embedded payment backends to create transactions, polling or receiving callback payment statuses, matching webhook payment notifications, and ultimately reporting successful payment statuses back to `WebShopX`. > 📌 **Deployment Prerequisite**: This is an **optional dependency plugin** and must be used in conjunction with the core `WebShopX` plugin. It does not handle products or delivery logic on its own; installing it standalone will not provide any business functionality. --- ## Supported Payment Methods This page summarizes the payment solutions currently supported or implemented by `WebShopX-Payments`, allowing you to quickly evaluate availability and integration priorities. | **Status** | **Platform** | **Solution** | **Description** | | :--- | :--- | :--- | :--- | | 🟢 | Alipay | (https://open.alipay.com/api/detail?code=I1080300001000068149&index=0) | **Official API**. The server calls the official API to generate a dynamic payment QR code for users to scan and pay. | | 🔵 | WeChat Pay | (https://pay.weixin.qq.com/static/product/product_intro.shtml?name=native) | **Official API**. Standard QR code payment mode. The system generates a QR code, and scanning it launches the standard WeChat checkout window. | | 🟢 | PayPal | (https://developer.paypal.com/docs/api/orders/v2/) | **Official API**. Calls the official PayPal Orders API to dynamically generate payment approval links or QR codes. | | 🟡 | MercadoPago | (https://www.mercadopago.com.br/developers/) | **Official API**. Integration with the official MercadoPago interface. | | 🟢 | Stripe | (https://docs.stripe.com/) | **Official API**. Integrated with its standard web payment flow, supporting multi-currency and various international credit cards. | | 🔵 | Alipay | No-License Hook | **Third-party Solution**. The backend configures a fixed-amount receiving QR code and intercepts open platform transaction notifications or billing info via Hook for automated callbacks. | | 🔵 | WeChat Pay | No-License Hook | **Third-party Solution**. The backend configures a fixed-amount receiving QR code and intercepts real-time payment notifications from WeChat PC client via Hook to match amounts and confirm payments. | > - **🟢 Fully Verified**: The solution is viable. Developers have completed full-process closed-loop testing and confirmed it functions normally. > - **🔵 Indirectly Verified**: The solution is viable. Tested and successfully reported by other users, though not personally verified by the developers. > - **🟡 Pending Verification**: The code has been implemented. However, due to developers lacking relevant API permissions/credentials, actual testing has not yet been performed. --- ## Quick Start 1. Place `WebShopX-Payments.jar` into your server's `plugins` folder. 2. Restart the server to generate the default configuration files. 3. Open the `plugins/WebShopX-Payments/` directory, m