Genshin Impact Genesis Crystals API for Resellers
Short Answer
Genshin Impact Genesis Crystals are the premium in-game currency used to pull characters and weapons. Resellers supply them via a direct top-up API: the buyer provides their UID (unique player identifier) and selects their server region, the API credits Crystals to the account. There are no redeemable codes — delivery is direct to the account. Server selection is mandatory; Genshin has four distinct server regions, and topping up to the wrong server is irreversible.
Definition: Genshin Impact Genesis Crystals top-up reselling means purchasing Crystal credits at wholesale from a B2B supplier API and delivering them directly to buyer accounts via UID + server lookup, without generating a redeemable code.
Key takeaway: Genshin Impact has a global, high-spending player base. The typical Genshin buyer spends more per transaction than PUBG or ML buyers — Crystal top-ups often range from $5 to $100+. Per-order margin is higher in absolute terms, which makes it attractive even at moderate volumes. The integration complexity is the same as other top-up products: UID validation + server selection + async order fulfillment.
Who This Guide Is For
- Resellers adding top-up products for global gaming audiences
- Telegram bot operators serving Genshin Impact players
- Online stores targeting the 18–30 anime/RPG gaming demographic
- Marketplace operators evaluating high-value gaming top-ups
Genshin Impact Currency Structure
Understanding what you're selling:
| Currency | How Obtained | Used For |
|---|---|---|
| Genesis Crystals | Real-money purchase or top-up | Convert to Primogems (2:1 for first purchase bonus), or buy Blessing of the Welkin Moon |
| Primogems | Gameplay + Crystal conversion | Wish (gacha pulls for characters/weapons) |
| Intertwined Fate / Acquaint Fate | Purchased with Primogems | Actual pull mechanic |
When resellers sell a "Genesis Crystal top-up," the buyer receives Genesis Crystals. They then convert to Primogems inside the game.
Genshin Server Regions
Server selection is required at top-up time. Genshin Impact has four server regions:
| Server | Region | Label in API |
|---|---|---|
| Asia | Southeast Asia, Japan, Korea | asia |
| America | North/South America | os_usa |
| Europe | Europe, Russia, Middle East | os_euro |
| TW, HK, MO | Taiwan, Hong Kong, Macau | os_cht |
A UID from the Asia server cannot receive top-up via the America server endpoint. Always confirm server with buyer before placing order.
Where do players find their UID and server? In-game: tap the character portrait → lower-left shows UID and server label.
API Flow for Genshin Top-Up
Step 1: Validate UID and Server
POST /validate-player
{ "uid": "800123456", "server": "asia", "game": "genshin" }
→ { "valid": true, "username": "Traveler_KH" }
Step 2: Show username confirmation to buyer
"Topping up account: Traveler_KH (Asia server). Confirm?"
Step 3: Place order after buyer confirms + payment received
POST /topup
{ "uid": "800123456", "server": "asia", "amount_id": "genshin-crystals-980" }
→ { "order_id": "ORD-002", "status": "processing" }
Step 4: Poll or webhook for completion
GET /orders/ORD-002
→ { "status": "completed", "crystals_credited": 980 }
Crystal Package Reference (Illustrative)
Exact packages and pricing are set by miHoYo (HoYoverse) and change periodically. The following is illustrative.
| Package | Genesis Crystals | Approx. Retail Price |
|---|---|---|
| Minimum | 60 | ~$1.00 |
| Small | 300 | ~$5.00 |
| Medium | 980 | ~$15.00 |
| Standard | 1980 | ~$30.00 |
| Large | 3280 | ~$50.00 |
| Mega | 6480 | ~$100.00 |
Blessing of the Welkin Moon (30-day subscription giving Primogems daily) is also available via top-up API at some suppliers — typically retailing at ~$5.
Margin Structure (Illustrative)
Illustrative example only. Actual rates depend on supplier and volume.
Standard sale:
| Variable | Amount |
|---|---|
| Customer pays (retail) | $30.00 |
| Wholesale cost | $27.60 |
| Gross margin | $2.40 |
| Payment processing (2.5%) | $0.75 |
| Net profit | $1.65 |
| Net margin | 5.5% |
Crypto payment (lower fee):
| Variable | Amount |
|---|---|
| Customer pays (retail) | $30.00 |
| Wholesale cost | $27.60 |
| Payment fee (0.5%) | $0.15 |
| Net profit | $2.25 |
| Net margin | 7.5% |
At $100 top-ups with 7.5% net margin: $7.50 per transaction. High-value Genshin buyers make this product attractive even at moderate volume.
Critical Risk: Wrong Server Top-Up
Genshin top-ups to the wrong server are unrecoverable. HoYoverse does not transfer Crystals between servers. If a buyer provides the wrong server, the Crystals go to the wrong account location and cannot be retrieved.
Mitigation stack:
- Validate UID + server before accepting payment
- Display the validated username and server label back to buyer
- Require explicit buyer confirmation with the displayed account name
- Store the validation response (username + server) with the order record
- State in your terms: "Server selection is buyer's responsibility. Top-ups cannot be reversed after delivery."
Comparing Genshin to Other Top-Up Products
| Dimension | Genshin Impact | PUBG UC | ML Diamonds |
|---|---|---|---|
| Player age range | 18–35 | 15–30 | 15–28 |
| Avg. transaction size | High ($15–$100) | Medium ($5–$50) | Low–Medium ($1–$35) |
| Purchase frequency | Irregular (banner-driven) | Regular (weekly/monthly) | Regular (weekly/monthly) |
| Server validation | Required (4 regions) | Required (game ID) | Required (zone ID) |
| Code delivery | No (direct top-up) | No (direct top-up) | No (direct top-up) |
| Global demand | Very high | Very high | High (SEA-focused) |
Checklist
- Confirm supplier offers Genshin Impact Genesis Crystals top-up
- Implement UID + server selection in buyer flow
- Call validation endpoint with UID and server before payment
- Display validated username and server to buyer for confirmation
- Accept payment only after buyer explicitly confirms
- Place order and poll for completion (most orders complete in 1–5 minutes)
- Display order reference to buyer on success
- Define error handling: invalid UID, wrong server, order failure
- Add Blessing of the Welkin Moon as separate product if supplier supports it
- Clearly state in terms: server selection is buyer's responsibility