Accept crypto donations on Metin2
Let your Metin2 players donate with Bitcoin, Ethereum, USDT and 30+ coins. Players buy coins on the hosted checkout and the item is delivered through the item_award queue — handed to the player on their next login — automatically from the signed webhook.
How to accept crypto donations on Metin2
Follow these steps to start taking Bitcoin, Ethereum, USDT and 30+ other coins.
-
Upload the module
Upload the module folder (e.g.
/donate) on a host that can reach your Metin2 MySQL databases (accountandplayer) over HTTPS. -
Run the web installer
Open
/donate/install.php, connect the database and detectaccount.accountandplayer.item_award. -
Set the donate item
Enter the item ID (
vnum) to grant per coin, set the price and your API key, then deleteinstall.php. -
Link the donation form
Send players to the donation form, where they enter their account name and number of coins.
-
Items are delivered automatically
On a confirmed payment, the item is queued in
item_awardand handed to the player on next login — delivered at most once, even on retries.
Need the full reference? See the API & webhook documentation, or read about the crypto payment gateway.
Requirements & compatibility
- Metin2 server (MySQL: account / player)
- PHP 5.6+ with cURL
- Host that can reach the game DB over HTTPS
- A free CryptoPayr account & API key
Frequently asked questions
How are items delivered?
The module inserts the item into the item_award queue in the player database, so the game hands it to the player the next time they log in.
Can I grant any item?
Yes. Set the item ID (vnum) in the installer; use a stackable donate item since the quantity equals the number of coins purchased.
Is delivery duplicate-safe?
Yes — each order is claimed atomically, so the item is granted at most once even if the webhook is retried.
Which coins can players use?
Bitcoin, Ethereum, USDT, USDC, BNB and 30+ more, chosen at the hosted checkout.
