Money Shop

Complete guide and documentation

Money Shop

The Money Shop handles real money transactions with products and flash offers to maximize revenue and player engagement.

External purchase notification (server-to-server)

When a payment provider such as IDC Payment (idcpayment) confirms a purchase, it must notify the Game Panel with a single HTTP POST. The panel records the purchase and delivers the product rewards.

POST https://gamepanel.idcgames.com/api/v1/webhooks/idcpayment/games/{game_id}

Copy the exact URL per game from Games → Edit Game → IDC Payment — Callback URL. IDC Payment sends native JSON with headers X-IDC-Notification-Id, X-IDC-Timestamp, X-IDC-Signature: sha256=… (see docs/IDC_PAYMENT_CALLBACK.md).

  • Signature: HMAC-SHA256 of timestamp + "." + raw body with game secret; max 300s skew
  • Secret key: IDC secret_key in platform config, or GamePanel Secret Token
  • IDC users: useridc → platform=idc, platform_user_id
  • Product: bought_data[].game_item_id (or token) = Game Product External reference
  • Idempotency: unique transactionid

Generic adapter (other providers): POST …/api/v1/purchases/external — see EXTERNAL_PURCHASES_API_GUIDE.md.

Legacy generic JSON example (/purchases/external) 
{
  "game_id": 1,
  "gamepanel_secret_token": "gp_…",
  "platform": "idc",
  "platform_user_id": "uuid-from-idc",
  "external_reference": "starter_pack_v1",
  "external_transaction_id": "idcpayment_order_123",
  "quantity": 1,
  "payment_method": "idcpayment"
}

Full IDC Payment spec: docs/IDC_PAYMENT_CALLBACK.md and EXTERNAL_PURCHASES_API_GUIDE.md.

Product Management

  • Product Creation: Create real money products with custom pricing
  • Product Categories: Organize products by type and value
  • Regional Pricing: Set different prices for different regions
  • Product Bundles: Create product bundles for better value

Flash Offers

  • Limited Time Offers: Create time-limited promotional offers
  • Discount Management: Set up percentage or fixed amount discounts
  • Offer Scheduling: Schedule offers to start and end automatically
  • Targeted Offers: Create offers for specific player segments

Payment Processing

  • Multiple Payment Methods: Support various payment providers
  • Secure Transactions: Encrypted payment processing
  • Refund Management: Handle refunds and chargebacks
  • Transaction Tracking: Complete audit trail of all transactions

Analytics

  • Revenue Tracking: Monitor revenue from different products
  • Conversion Rates: Track offer conversion and effectiveness
  • Player Spending: Analyze player spending patterns
  • A/B Testing: Test different offers and pricing strategies
Back to Documentation
Overview