Marketplace में Digital Goods Catalog कैसे Connect करें

संक्षिप्त उत्तर

Digital goods को marketplace से connect करने का मतलब है gift cards, game top-ups और similar products को new category के रूप में add करने के लिए existing marketplace infrastructure में supplier API integrate करना। Integration में तीन phases होती हैं: catalog import (supplier से products pull करके listings create करना), order flow (purchase पर supplier API trigger करना), और stock management (supplier availability के साथ listings sync रखना)। Technical work one-time build है; ongoing operations automated हैं।

परिभाषा: Marketplace में digital goods catalog connect करने का मतलब है wholesale supplier के API का use करके new product category populate करना, orders automatically fulfill करना, और accurate stock और pricing maintain करना — marketplace operator द्वारा कोई physical inventory handle किए बिना।

मुख्य निष्कर्ष: Digital goods marketplace expansion के लिए most backend-integration-friendly product category हैं। कोई warehouse नहीं, कोई logistics नहीं, कोई returns process नहीं। पूरी fulfillment chain: API call in → code out। Complexity catalog management (region accuracy, naming, pricing) और order flow reliability में है — physical operations में नहीं।

यह Guide किसके लिए है

• New product category के रूप में digital goods add करने वाले marketplace operators
• Existing platform में digital goods supplier API integrate करने वाले developers
• Digital goods के लिए integration requirements define करने वाले product managers

Integration Architecture Overview

Marketplace                    FoxReload API
    │                               │
    ├─ Phase 1: Catalog Import ─────▶ GET /api/categories/ + GET /api/products/?category_id_or_slug=...
    │  सभी products pull करें        products, prices, regions return करता है
    │  Marketplace listings create   (daily scheduled job)
    │                               │
    ├─ Phase 2: Stock Sync ─────────▶ GET /api/products/{id_or_slug}
    │  Product दिखाने से पहले check   inStock field return करता है
    │  (product page + checkout)     │
    │                               │
    ├─ Phase 3: Order Flow ─────────▶ POST /api/orders/
    │  Buyer checkout complete करता   { items: [{itemId, quantity}] }
    │  Marketplace payment deduct     │
    │                          ◀─────┤ { id: "ord_...", status: "active" }
    │  GET /api/orders/{id} poll ───▶ │
    │                          ◀─────┤ { status: "completed", items[].externalData }
    │  Buyer को code deliver करें     │
    │                               │
    └─ Phase 4: Reconciliation ─────▶ GET /api/orders/?limit=200&offset=0
       Daily finance export          सभी orders return करता है (pagination)

Phase 1: Catalog Import

API क्या Return करता है

Typical supplier catalog endpoint return करता है:

{
  "products": [
    {
      "sku": "steam-20-usd",
      "name": "Steam Gift Card $20",
      "region": "US",
      "currency": "USD",
      "face_value": 20.00,
      "wholesale_price": 18.40,
      "category": "gaming",
      "in_stock": true
    }
  ]
}

Marketplace Listings पर कैसे Map करें

Rules:

• Per supplier SKU एक marketplace listing — कोई merging नहीं
• Product title में हमेशा region include करें
• Order placement पर back-map करने के लिए supplier SKU अपने database में store करें

Catalog Update Schedule

Phase 2: Stock Management

Buyers को केवल in-stock products दिखाएँ। दो points पर availability check करें:

1. Product listing page load — availability दिखाने के लिए GET /api/products/{id_or_slug} query करें
2. Checkout initiation — stock फिर check करें; page load के बाद out of stock हो तो checkout block करें

GET /api/products/steam-20-usd
→ { "id": "product_01k...", "inStock": true, ... }

API load reduce करने के लिए 5–15 minutes (longer नहीं) के लिए stock responses cache करें।

Phase 3: Order Flow

जब buyer checkout complete करता है:

1. Marketplace payment confirm करता है (buyer charged)
2. POST /api/orders/ call करें:
   {"items": [{"itemId": "product_01k...", "quantity": 1}]}
3. order_id मिला; GET /api/orders/{order_id} poll करें (हर 3-5s)
4. status == "completed" पर items[].externalData से code(s) parse करें
5. अपने database में order_id और codes store करें
6. Buyer को code deliver करें (in-app notification, email, या order history page)
7. Order completed mark करें

Error handling:

Phase 4: Reconciliation

Finance reconciliation के लिए supplier API से daily order history pull करें:

GET /api/orders/?limit=200&offset=0
→ [ { id, status, items, createdAt, ... }, ... ]

(FoxReload में date-range filter नहीं है — pagination से full history pull करें।)

अपने marketplace transaction records के against match करें। Discrepancies investigation require करती हैं।

Marketplace Digital Goods के लिए Pricing Strategy

Retail price wholesale cost + marketplace commission + payment fee + target margin से ऊपर set करें:

Retail price = Wholesale ÷ (1 − marketplace_commission% − payment_fee% − target_margin%)

Example (marketplace 10% commission, card payment 2.5%, target margin 5%):

Retail = $18.40 ÷ (1 − 0.10 − 0.025 − 0.05)
Retail = $18.40 ÷ 0.825
Retail = $22.30

Verify करें कि यह retail price competitive है। नहीं है तो या better wholesale pricing negotiate करें या evaluate करें कि यह channel इस product के लिए viable है।

Catalog Size Recommendations

Focused शुरू करें; integration validate करने के बाद expand करें:

Fulfillment flow validate करने से पहले 200 SKUs के साथ शुरू करना debugging complexity create करता है। Narrow शुरू करें; pipeline proven होने के बाद scale करें।

Technical Checklist

Catalog:

• Supplier API credentials (X-API-Key) configured हों; isMock: true से tested हों
• Catalog import job scheduled हो (minimum daily)
• हर supplier SKU 1:1 marketplace listing पर mapped हो
• सभी regional products के product title में Region included हो
• हर product पर margin formula apply करके retail price calculated हो

Stock:

• Product page load पर stock check implemented हो
• Checkout initiation पर stock check implemented हो
• Cache TTL 5–15 minutes set हो
• Out-of-stock products hidden या unavailable marked हों

Orders:

• Order creation call payment confirmation पर triggered हो (initiation पर नहीं)
• Supplier order ID आपके order database में stored हो
• Order completion पर buyer को code delivered हो
• Error states handled हों: timeout, failure, out-of-stock
• Threshold से ऊपर order failures के लिए alert configured हो

Finance:

• Supplier order API के against daily reconciliation job हो
• Discrepancy alerting configured हो
• Margin reporting के लिए हर order पर wholesale cost recorded हो