QuickPass Store Integration with Main Product

Definitions

Credits - internal currency of the main product
QuickPass Coins - internal currency of QuickPass that users spend in the store
Nominal Product - product with fixed credit amount and limited stock

What is Store Integration

Store integration allows selling main product credits through the QuickPass store. Users can spend QuickPass coins to receive credits in the main product.

How it Works

User selects a product in QuickPass store (e.g., "500 credits")
Pays with QuickPass coins for the purchase
QuickPass sends a request to the main product to credit the amount
Main product confirms the crediting
User receives credits in the main product

Product Example

"500 Credits"

User sees the product in QuickPass store
Price: 100 QuickPass coins
Available: 50 pieces (stock controlled by QuickPass)
Upon purchase receives 500 main product credits
Stock automatically decreases: 49 pieces

Requirements from Main Product Team

Minimum Requirements

API for crediting - endpoint for receiving crediting requests
User validation - checking user existence in the system
Operation confirmation - returning status of successful/unsuccessful crediting

Technical Integration Implementation

API endpoint for crediting:

POST /api/v1/credits/increase
Content-Type: application/json
Authorization: Bearer {api_key}

{
  "user_id": "12345",
  "amount": 500,
  "currency": "credits",
  "order_id": "qp_order_789",
  "product_name": "500 credits",
  "source": "quickpass_store"
}

Response from main product:

{
  "success": true,
  "transaction_id": "tx_456",
  "new_balance": 2500, // if needed
  "credited_amount": 500
}

On error:

{
  "success": false,
  "error_code": "USER_NOT_FOUND",
  "error_message": "User not found",
  "retry_allowed": false
}

Main Product Product Types

Game Currency (Nominal Products)

Credits - main currency for bets and purchases
- 100 credits (stock: 200 pcs.)
- 500 credits (stock: 150 pcs.)
- 1000 credits (stock: 75 pcs.)
Premium Currency - for exclusive features
- 50 crystals (stock: 30 pcs.)
Bonus Points - loyalty accumulation system
- 200 bonus points (stock: 100 pcs.)

Game Advantages

Free Spins/Free Bets - free games or bets
Multipliers - increased coefficients for a certain time
Cashback Bonuses - return of part of lost funds

Statuses and Privileges

VIP Status - premium features for a period
Increased Limits - higher bet amounts
Exclusive Access - to closed games and tournaments

Purchase Processing Flow

Action Sequence

Product Selection in QuickPass
- User selects main product item
- QuickPass coin balance is checked
Order Creation
- QuickPass checks product stock (availability)
- Creates order with "Processing" status
- Decreases product stock by 1 unit
- QuickPass coins are reserved on user account
Request to Main Product
- Sending purchase data via API
- Waiting for confirmation within 30 seconds
Response Processing
- On success: deduct QuickPass coins, complete order
- On error: return QuickPass coins, cancel order
User Notification
- About successful purchase and credit crediting
- Or about error with fund return

Error Handling

Temporary Errors (network, timeout):

Automatic retries (3 times with 10 sec intervals)
On failure - return coins and notify user

Critical Errors (user not found):

Immediate order cancellation
Return QuickPass coins
Restore product stock (+1 unit)
Logging for analysis

Partial Errors (insufficient funds in main product):

Return QuickPass coins
Restore product stock (+1 unit)
Notification with explanation

"Product Out of Stock" Errors:

Display "Out of Stock" in store
Automatic product hiding when stock = 0
Admin notifications about need for restocking

Product Configuration in QuickPass

Main Product Item Creation

Basic Information:
- Name: "1000 credits"
- Description: "Top up balance in main product"
- Price: 200 QuickPass coins
Stock Management:
- Initial stock: 100 pieces
- Current stock: 67 pieces
- Minimum stock for alert: 10 pieces
- Auto-hide when stock: 0
Integration Parameters:
- Resource type: "external_currency"
- API endpoint: "/api/v1/credits/increase"
- Amount to credit: 1000
- Currency: "credits"
Delivery Settings:
- Method: "API call"
- Timeout: 30 seconds
- Retries: 3 attempts