Accept crypto donations on Ragnarok Online
Let your Ragnarok Online players donate with Bitcoin, Ethereum, USDT and 110+ coins. Players buy Cash Points on the hosted checkout and they are credited to their account automatically from the signed webhook — spendable in the in-game Cash Shop. Works with rAthena and Hercules, just like FluxCP donations.
How to accept crypto donations on Ragnarok Online
Follow these steps to start taking Bitcoin, Ethereum, USDT and 110+ other coins.
-
Upload the module
Upload the module folder (e.g.
/donate) on a host that can reach your rAthena MySQL database over HTTPS. -
Run the web installer
Open
/donate/install.php, connect the database and detect theloginandacc_reg_numtables. -
Set price & API key
Set the price per Cash Point, the currency and your API key from Dashboard → Developers, then delete
install.php. -
Link the donation form
Send players to the donation form, where they enter their account username and how many Cash Points to buy.
-
Cash Points are credited automatically
On a confirmed payment, the signed webhook adds
#CASHPOINTSto the account — 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
- rAthena or Hercules (MySQL)
- 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 Cash Points credited?
The module adds to the account's #CASHPOINTS variable in acc_reg_num — the same value FluxCP uses — so players can spend them in the in-game Cash Shop.
Does it work with Hercules?
Yes. Both rAthena and Hercules use the same account variable store, and the variable name is configurable.
Is crediting duplicate-safe?
Yes — each order is claimed atomically, so points are credited at most once even if the webhook is retried.
Which coins can players use?
Bitcoin, Ethereum, USDT, USDC, BNB and 110+ more, chosen at the hosted checkout.
