FoxReload ऑर्डर फ़्लो — रिज़र्वेशन से डिलीवरी तक

FoxReload API पर ऑर्डर एक state machine से गुज़रते हैं। समझना कि कौन सा state कब आता है — पार्टनर को बेहतर UX और troubleshooting करने में मदद करता है।

State machine

Step-by-step flow

1. ऑर्डर create (pending)

curl -X POST https://api.foxreload.com/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"sku_id": "xbox-ar-game-pass", "quantity": 1}'

रिस्पॉन्स:

{
  "order_id": "ord_xyz789",
  "status": "pending",
  "created_at": "2026-05-18T14:32:00Z"
}

इस point पर FoxReload चेक करता है: SKU exists, partner के पास balance है, rate limit OK है।

2. Stock reservation (reserved)

200ms के अंदर, FoxReload internal database में stock एक record reserve करता है। यह 3 मिनट के लिए valid है — अगर payment उस समय में confirm नहीं हुआ, automatically release होगा।

3. Fulfilment (processing)

पार्टनर balance से wholesale cost debit होता है। backend supplier API call करता है (अगर upstream supplier है) या internal vault से code निकालता है।

4. Delivery (delivered)

Webhook भेजा जाता है आपके endpoint पर। response में delivery_data.code होगा — यह तुरंत customer को email/dashboard में दिखाएं।

Failure scenarios

Hr failed ऑर्डर पर webhook में failure_reason field होगी — आपका UI इसे customer-friendly message में convert करे।

Timing expectations

• Median delivery: 12 seconds (API call से webhook तक)।
• 95th percentile: 45 seconds।
• 99th percentile: 90 seconds।
• Timeout: 5 मिनट — इसके बाद auto-fail और refund।

Polling vs webhooks

Webhooks recommend किए जाते हैं, लेकिन अगर polling चाहिए:

curl https://api.foxreload.com/v1/orders/ord_xyz789 \
  -H "Authorization: Bearer YOUR_API_KEY"

Polling के लिए: 5-second intervals से ज़्यादा not allowed (rate limit)।

Best practices

• Idempotency key: ऑर्डर create करते समय Idempotency-Key हेडर भेजें (UUIDv4) — accidental double-orders से बचाव।
• Retry logic: HTTP 5xx पर max 3 retries, exponential backoff।
• Order tracking: हर ऑर्डर का state changes log करें — auditing के लिए।
• Failed orders display: Customer को retry-able failures और permanent failures अलग दिखाएं।

FoxReload API के order flow को समझना आपके reseller बिज़नेस में reliability का foundation है। 30-second median delivery, 95%+ success rate, और automatic refund-on-failure — यह वो basics हैं जो आपके customer experience को directly affect करते हैं।