راهنمای عملی برای صاحب سرورهایی که می‌خوان بازیکن از سایت خرید کنه، درگاه پرداخت رو تایید کنه، و همون لحظه پول یا آیتم بره تو اکانت بازی. بدون تیکت. بدون ادمین وسط کار.
This repo is bilingual. فارسی پایین، English further down.
اگه تا حالا اینجوری کار کردی که بازیکن کارت به کارت می‌کنه، اسکرین‌شات می‌فرسته، بعد یه ادمین باید دستی بهش وی‌آی‌پی بده، این راهنما همون چیزیه که کم داری.
کار درست اینه:
- بازیکن تو سایت لاگین می‌کنه (با همون یوزرنیم بازی)
- پکیج رو انتخاب می‌کنه
- می‌ره درگاه (زرین‌پال / زیبال / آیدی‌پی یا درگاه ارزی)
- پول رو می‌ده
- سایت از API خود درگاه می‌پرسه این تراکنش واقعاً successe یا نه
- اگه successe، همون لحظه تو دیتابیس بازی ذخیره می‌شه
- سرور بازی از دیتابیس می‌خونه و به بازیکن می‌ده
ادمین این وسط هیچ کاری نباید بکنه. اگه ادمین هنوز باید تایید کنه، سیستم‌ت نصفه است.
| بخش | لینک |
|---|---|
| از کجا شروع کنی | docs/fa/00-shoru.md |
| معماری کل سیستم | docs/fa/01-memari.md |
| زرین‌پال | docs/fa/02-zarinpal.md |
| زیبال | docs/fa/03-zibal.md |
| آیدی‌پی | docs/fa/04-idpay.md |
| درگاه ارزی / کریپتو | docs/fa/05-dargah-arzi.md |
| تحویل خودکار بدون ادمین | docs/fa/06-tahvil-khodkar.md |
| SAMP | docs/fa/07-samp.md |
| MTA | docs/fa/08-mta.md |
| FiveM | docs/fa/09-fivem.md |
| امنیت و اشتباهات رایج | docs/fa/10-amniyat.md |
| سوالات پرتکرار | docs/fa/11-soalat.md |
| خروجی واقعی API (کنسول) | docs/fa/12-khoroji-api.md |
نمونه کد PHP، SQL، Pawn و Lua هم تو پوشه examples هست. خروجی خام درگاه‌ها (همان چیزی که API برمی‌گرداند) تو examples/console است. کپی‌پیست کورکورانه نکن. اول بخون، بعد با گیم‌مد خودت جور کن.
درگاه‌های ایرانی برای کالای مجازی قوانین خودشون رو دارن. قبل از اینکه مرچنت بگیری، تو پنل زرین‌پال / زیبال / آیدی‌پی ببین فروش آیتم بازی قبول می‌کنن یا نه. اگه موضوع فعالیت‌ت با قوانین درگاه نخونه، بعداً حساب‌ت بسته می‌شه و بازیکن‌ها پول‌شون معلق می‌مونه. این بخش رو جدی بگیر.
برای من قبول کردن باید اثبات کنید که یک راه درامد مالی هست و تفهیم کنید که پرداخت درون برنامه ای هستش
If your players still pay, send a screenshot, and wait for an admin to hand out VIP, this guide is for you.
The flow should be:
- Player logs into the shop with their game username
- Picks a package
- Pays on ZarinPal / Zibal / IDPay, or a currency / crypto gateway
- Your site asks the gateway API if that payment is real
- If it is, the item or money is written to the game database immediately
- The game server reads that row and gives it to the player
No admin in the middle. If an admin still has to click “approve”, the shop is unfinished.
| Topic | Link |
|---|---|
| Start here | docs/en/00-start.md |
| System architecture | docs/en/01-architecture.md |
| ZarinPal | docs/en/02-zarinpal.md |
| Zibal | docs/en/03-zibal.md |
| IDPay | docs/en/04-idpay.md |
| Currency / crypto gateways | docs/en/05-currency-gateways.md |
| Auto delivery | docs/en/06-auto-delivery.md |
| SAMP | docs/en/07-samp.md |
| MTA | docs/en/08-mta.md |
| FiveM | docs/en/09-fivem.md |
| Security | docs/en/10-security.md |
| FAQ | docs/en/11-faq.md |
| Live API console output | docs/en/12-api-output.md |
Sample PHP, SQL, Pawn and Lua live in examples. Raw gateway responses (copy-paste console dumps) are in examples/console. Read them first. Then wire them into your gamemode, not a random one from 2014.
Iranian card gateways have their own rules for virtual goods. Check the merchant terms before you go live. If the gateway later freezes the account, players are the ones who get stuck.
سوال، باگ نمونه کد، یا اینکه یه بخش برات گنگه:
If something in the samples is wrong for your gamemode, say which server (SAMP / MTA / FiveM) and which database you use. “It doesn’t work” without that doesn’t help much.