POST /apiv2/order5m

Netts کے اندرونی Energy پولز کے ذریعے 5 منٹ کا Energy کرایہ آرڈر بنائیں۔

اینڈ پوائنٹ URL

POST https://netts.io/apiv2/order5m

درخواست کے ہیڈرز

Header	مطلوب ہے	تفصیل
Content-Type	ہاں	application/json
X-API-KEY	ہاں	Netts ڈیش بورڈ سے آپ کی API کلید
X-Real-IP	ہاں	آپ کی وائٹ لسٹ سے IP پتہ

درخواست کا باڈی

json

{
    "amount": 65000,
    "receiveAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
}

درخواست کے پیرامیٹرز

Parameter	Type	مطلوب ہے	تفصیل
amount	integer	ہاں	کرایہ پر لینے کے لیے Energy کی مقدار (کم از کم: 61,000، زیادہ سے زیادہ: 650,000)
receiveAddress	string	ہاں	TRON پتہ جو Energy وصول کرے گا (TRC-20 فارمیٹ)

Energy کی حدیں

5 منٹ کا اینڈ پوائنٹ فی آرڈر 61,000 اور 650,000 یونٹس کے درمیان Energy کی مقدار قبول کرتا ہے۔ اس حد سے باہر کی درخواستیں HTTP 400 کے ساتھ مسترد کر دی جائیں گی۔

فراہم کنندہ کی معلومات

5 منٹ کے Energy آرڈرز خصوصی طور پر Netts کے اندرونی Energy پولز کے ذریعے پورے کیے جاتے ہیں۔ 1 گھنٹے کے اینڈ پوائنٹ کے برعکس، بیرونی فراہم کنندگان استعمال نہیں کیے جاتے۔

دستیابی اور دوبارہ کوشش کی حکمت عملی

چونکہ ڈیلیگیشنز صرف اندرونی پولز سے آتی ہیں، اس لیے زیادہ ڈیمانڈ کے ادوار کے دوران عارضی عدم دستیابی ممکن ہے۔ اگر آپ کو 503 کی خرابی موصول ہوتی ہے، تو تھوڑی تاخیر کے بعد درخواست کی دوبارہ کوشش کریں یا 1 گھنٹے کے اینڈ پوائنٹ پر واپس جائیں جس کے پاس متعدد بیرونی فراہم کنندگان تک رسائی ہے۔

مثالیں

cURL

bash

curl -X POST https://netts.io/apiv2/order5m \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip" \
  -d '{
    "amount": 65000,
    "receiveAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
  }'

Python

python

import requests

url = "https://netts.io/apiv2/order5m"
headers = {
    "Content-Type": "application/json",
    "X-API-KEY": "your_api_key",
    "X-Real-IP": "your_whitelisted_ip"
}

payload = {
    "amount": 65000,
    "receiveAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()

if response.status_code == 200:
    detail = data.get('detail', {})
    order_data = detail.get('data', {})
    print(f"Order ID: {order_data.get('orderId')}")
    print(f"Transaction Hash: {order_data.get('hash')}")
    print(f"Energy Delivered: {order_data.get('energy')}")
    print(f"Cost: {order_data.get('paidTRX')} TRX")
    print(f"Delegate Address: {order_data.get('delegateAddress')}")
elif response.status_code == 503:
    # Pool temporarily unavailable - retry or fallback to 1h
    print("Pool busy, retrying in 2 seconds...")
else:
    error_detail = data.get('detail', data)
    print(f"Error Code: {error_detail.get('code', 'N/A')}")
    print(f"Error Message: {error_detail.get('msg', error_detail)}")

جواب

کامیابی کا جواب (200 OK)

json

{
    "detail": {
        "code": 10000,
        "msg": "Successful, 1.430 TRX deducted",
        "data": {
            "orderId": "5Mb4ee11ef86",
            "paidTRX": 1.43,
            "hash": "3636f97dde244fca17cdc0b2cf7fd1572a9b4c6d8e0f1a3b5c7d9e1f3a5b7c9d",
            "delegateAddress": "TNp5gsJhBmZFXgCdgjMgr8pEZ8fHgXUHDq",
            "energy": 65050
        }
    }
}

پتہ کی ایکٹیویشن کے ساتھ کامیابی (200 OK)

جب وصول کنندہ کا پتہ TRON نیٹ ورک پر فعال نہ کیا گیا ہو، تو Netts اسے خودکار طور پر فعال کر دیتا ہے۔ ایکٹیویشن کی قیمت کل میں شامل کر دی جاتی ہے:

json

{
    "detail": {
        "code": 10000,
        "msg": "Successful, 1.430 TRX for energy + 1.100 TRX for address activation",
        "data": {
            "orderId": "5Mb4ee11ef86",
            "paidTRX": 2.53,
            "hash": "3636f97dde244fca17cdc0b2cf7fd1572a9b4c6d8e0f1a3b5c7d9e1f3a5b7c9d",
            "delegateAddress": "TNp5gsJhBmZFXgCdgjMgr8pEZ8fHgXUHDq",
            "energy": 65050,
            "activationHash": "bab38070a64b237acc9110ecf5135acc4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a"
        }
    }
}

جواب کے فیلڈز

Field	Type	تفصیل
detail.code	integer	کامیاب آرڈرز کے لیے ہمیشہ `10000`
detail.msg	string	کٹوتی کی گئی رقم کے ساتھ کامیابی کا پیغام
detail.data.orderId	string	یکساں آرڈر ID (فارمیٹ: `5M{id}`)
detail.data.paidTRX	number	TRX میں کل لاگت (اگر قابل اطلاق ہو تو ایکٹیویشن فیس شامل ہے)
detail.data.hash	string	ڈیلیگیشن ٹرانزیکشن ہیش
detail.data.delegateAddress	string	پول کا پتہ جس نے Energy ڈیلیگیٹ کی
detail.data.energy	integer	Energy کی مقدار + بفر (عام طور پر +50)
detail.data.activationHash	string	صرف تب موجود ہوتا ہے اگر پتہ کی ایکٹیویشن کی گئی ہو

خرابی کے جوابات

غلط Energy کی مقدار (400)

json

{
    "code": 1003,
    "msg": "Energy amount must be between 61000 and 650000. Requested: 50000"
}

تصدیق کی خرابی (401)

json

{
    "detail": "Invalid API key or IP not in whitelist"
}

ناکافی بیلنس (403)

json

{
    "code": 1004,
    "msg": "Insufficient funds. Required: 1.43 TRX, Available: 0.50 TRX"
}

سروس دستیاب نہیں ہے (503)

json

{
    "code": 5003,
    "msg": "Service temporarily unavailable. Energy delegation failed after retries."
}

503 خرابیوں کو سنبھالنا

503 جواب کا مطلب ہے کہ اندرونی پولز عارضی طور پر مکمل گنجائش پر ہیں۔ تجویز کردہ حکمت عملی:

2-3 سیکنڈ انتظار کریں اور 5 منٹ کے آرڈر کی دوبارہ کوشش کریں
اگر پھر بھی دستیاب نہ ہو، تو 1 گھنٹے کے اینڈ پوائنٹ پر واپس جائیں جو متعدد فراہم کنندگان کا استعمال کرتا ہے

اندرونی سرور کی خرابی (500)

json

{
    "code": 5000,
    "msg": "Internal server error occurred"
}

خرابی کے کوڈز کا حوالہ

Code	تفصیل	HTTP اسٹیٹس
`10000`	کامیابی	200
`10000`	کامیابی (کیش شدہ جواب)	208
`-`	ڈپلیکیٹ درخواست پر ابھی کارروائی ہو رہی ہے	409
`1003`	Energy کی مقدار حد سے باہر ہے	400
`1004`	ناکافی بیلنس	403
`1005`	صارف کے ادائیگی کنندہ کا پتہ ترتیب نہیں دیا گیا	400
`5000`	اندرونی سرور کی خرابی	500
`5003`	Energy سروس دستیاب نہیں ہے	503

شرح کی حدود

اس اینڈ پوائنٹ پر مندرجہ ذیل شرح کی حدیں لاگو ہوتی ہیں (فی IP پتہ):

مدت	حد	تفصیل
1 سیکنڈ	50 درخواستیں	زیادہ سے زیادہ 50 درخواستیں فی سیکنڈ

شرح کی حد کے ہیڈرز

http

RateLimit-Limit: 50
RateLimit-Remaining: 49
RateLimit-Reset: 1
X-RateLimit-Limit-Second: 50
X-RateLimit-Remaining-Second: 49

شرح کی حد سے تجاوز (429)

json

{
    "message": "API rate limit exceeded"
}

ایڈیمپوٹینسی (Idempotency)

آرڈر کی ڈپلیکیٹ پروسیسنگ کو روکنے کے لیے API ایڈیمپوٹینسی کی معاونت کرتی ہے۔ جب آپ متعدد ایک جیسی درخواستیں بھیجتے ہیں، تو سسٹم اس بات کو یقینی بناتا ہے کہ آرڈر پر صرف ایک بار کارروائی ہو۔

ایڈیمپوٹینسی کیسے کام کرتی ہے

درخواست کی انفرادیت کا تعین مندرجہ ذیل کے امتزاج سے ہوتا ہے:

درخواست کا ٹائم اسٹیمپ (2 سیکنڈ کی ونڈو)
Energy کی مقدار
وصول کنندہ کا پتہ
API کلید

ہر درخواست کو 2 سیکنڈ کی انفرادیت کی ونڈو دی جاتی ہے۔ اس ونڈو کے اندر ایک جیسے پیرامیٹرز والی درخواستوں کو ڈپلیکیٹ سمجھا جاتا ہے۔

اپنی خود کی کلید فراہم کرنا

آپ X-Idempotency-Key ہیڈر بھیج کر ایڈیمپوٹینسی کو اپنے ہاتھ میں لے سکتے ہیں۔ جب یہ موجود ہو، تو صرف وہی قیمت یہ طے کرتی ہے کہ آیا کوئی درخواست دہراؤ ہے، اور اوپر دیا گیا خودکار امتزاج استعمال نہیں ہوتا۔ جب یہ غائب ہو، تو کچھ نہیں بدلتا — سرور آپ کے لیے کلید اخذ کرتا ہے۔

قواعد وہی ہیں جو /apiv2/order1h پر ہیں:


Header	`X-Idempotency-Key`
فارمیٹ	بالکل 64 چھوٹے حروف پر مشتمل ہیکساڈیسیمل کریکٹرز — ایک SHA-256 ڈائجسٹ
لائف ٹائم	اس کلید والی پہلی درخواست سے 24 گھنٹے
دائرہ کار	آپ کا اکاؤنٹ۔ کسی دوسرے اکاؤنٹ کی طرف سے بھیجی گئی وہی قیمت کبھی بھی آپ کا نتیجہ واپس نہیں کرتی

کسی بھی دوسرے فارمیٹ کی کلید — ڈیشز کے ساتھ UUID، بیس 64، بڑے حروف کا ہیکس — آرڈر دینے سے پہلے اور کچھ بھی چارج کیے جانے سے پہلے 400 کے ساتھ مسترد کر دی جاتی ہے:

json

{
    "detail": "Invalid idempotency key format. Must be 64-character hexadecimal string."
}

کلید کو اپنی API کلید سے اخذ کریں تاکہ یہ آپ کے اکاؤنٹ کے لیے منفرد ہو اور دوبارہ کوشش کرنے پر قابلِ تخلیقِ نو ہو — اس کی تفصیلی مثال 1 گھنٹے والے صفحے پر موجود ہے۔ جس پیغام کو آپ ہیش کرتے ہیں اس میں کرایہ کی مدت شامل کریں: ایک ہی پتے کو 5 منٹ اور 1 گھنٹے کے لیے کرایہ پر لینا مختلف آرڈرز ہیں، اور دونوں کے لیے ایک ہی کلید کو دوبارہ استعمال کرنے پر دوسری درخواست کے لیے پہلے آرڈر کا جواب واپس آئے گا۔

دو ایک جیسے آرڈرز دینا

وہی جال جیسا کہ فی گھنٹہ اینڈ پوائنٹ پر ہے، لیکن وسیع تر ونڈو کے ساتھ۔ دو ایک جیسے آرڈرز — ایک ہی پتے پر ایک ہی رقم — دوبارہ کوشش سے ناقابلِ تمیز ہوتے ہیں، اور صرف ان کی آمد کا وقت ہی انہیں الگ کرتا ہے۔

اپنی خود کی کلید کے بغیر:

دو درخواستوں کے درمیان وقفہ	کیا ہوتا ہے
اسی 2 سیکنڈ کی ونڈو کے اندر	دوسری درخواست کو دہراؤ سمجھا جاتا ہے۔ اس پر عمل نہیں کیا جاتا: آپ کو `208` اور پہلے آرڈر کا جواب ملتا ہے۔ اس کے لیے کچھ چارج نہیں کیا جاتا
دو سیکنڈ سے زیادہ کا فاصلہ	دو مختلف کلیدیں — دونوں آرڈر دیے جاتے ہیں اور دونوں کے لیے چارج کیا جاتا ہے

لہذا دو ایک جیسے آرڈرز کے درمیان دو سیکنڈ سے زیادہ کا وقفہ رکھیں، اور اسٹیٹس کوڈ پڑھیں: 208 کا مطلب ہے کہ آپ نے جو آرڈر ابھی بھیجا ہے وہ نہیں دیا گیا تھا۔

ایک وقفہ ایک متبادل حل ہے، مستقل علاج نہیں — یہ ان درخواستوں کو بھی الگ کرتا ہے جنہیں آپ کبھی دہرانا نہیں چاہتے تھے، جیسے کہ ٹائم آؤٹ کے بعد دوبارہ کوشش یا آپ کی قطار کی طرف سے دوبارہ بھیجا گیا پیغام، اور ان میں سے ہر ایک الگ چارج کے ساتھ ایک الگ آرڈر بن جاتا ہے۔ اپنی خود کی کلید بھیجنا ہی اصل حل ہے: ایک نئے آرڈر کے لیے ایک نیا nonce، دوبارہ کوشش کے لیے پہلی کوشش کا nonce۔ مکمل وجوہات 1 گھنٹے والے صفحے پر ہیں۔

ڈپلیکیٹ درخواستوں کے لیے HTTP اسٹیٹس کوڈز

اسٹیٹس کوڈ	نام	تفصیل
200	OK	آرڈر پر کامیابی سے کارروائی ہوئی (پہلی درخواست)
208	Already Reported	آرڈر پر پہلے ہی کارروائی ہو چکی ہے، کیش شدہ جواب واپس کیا جا رہا ہے
409	Conflict	درخواست پر فی الحال کارروائی ہو رہی ہے، دوبارہ کوشش نہ کریں

ڈپلیکیٹ درخواست - پہلے ہی کارروائی ہو چکی ہے (208)

json

{
    "detail": {
        "code": 10000,
        "msg": "Successful, 1.430 TRX deducted",
        "data": {
            "hash": "3636f97dde244fca17cdc0b2cf7fd1572a9b4c6d8e0f1a3b5c7d9e1f3a5b7c9d",
            "energy": 65050,
            "orderId": "5Mb4ee11ef86",
            "paidTRX": 1.43,
            "delegateAddress": "TNp5gsJhBmZFXgCdgjMgr8pEZ8fHgXUHDq"
        }
    },
    "idempotency": {
        "status": "completed",
        "cached": true,
        "original_created_at": "2026-03-21T08:53:52.498000"
    }
}

ڈپلیکیٹ درخواست - ابھی کارروائی جاری ہے (409)

json

{
    "success": false,
    "error": "duplicate_request_processing",
    "message": "This request is currently being processed. Please wait and do not retry.",
    "retry_after_seconds": 3
}

بہترین طریقہ کار

ایک جیسے پیرامیٹرز کے ساتھ متوازی درخواستیں نہ بھیجیں - ہر جواب کا انتظار کریں
فوراً دوبارہ کوشش کرنے کے بجائے انتظار کر کے 409 کے جوابات کو سنبھالیں
کیش شدہ جوابات کی شناخت کے لیے idempotency.cached فیلڈ کو چیک کریں

موازنہ: 5 منٹ بمقابلہ 1 گھنٹے کے آرڈرز

خصوصیت	5 منٹ کا آرڈر	1 گھنٹے کا آرڈر
اینڈ پوائنٹ	`/apiv2/order5m`	`/apiv2/order1h`
مدت	5 منٹ	1 گھنٹہ
Energy کی حد	61,000 - 650,000	61,000 - 3,000,000
فراہم کنندگان	صرف Netts کے اندرونی پولز	اندرونی پولز + بیرونی فراہم کنندگان
قیمت	کم (5 منٹ کی شرح)	معیاری فی گھنٹہ شرح
دستیابی	رش کے اوقات میں محدود ہو سکتی ہے	زیادہ (متعدد فراہم کنندگان کا متبادل)
بہترین برائے	بار بار ہونے والی چھوٹی ٹرانزیکشنز	بڑی یا گارنٹی شدہ ڈیلیوری

پوسٹ پیڈ اکاؤنٹس

پوسٹ پیڈ بلنگ والے اکاؤنٹس وہی اینڈ پوائنٹ، URL، ہیڈرز اور ریکویسٹ باڈی استعمال کرتے ہیں جو باقی سب کرتے ہیں۔ فرق صرف یہ ہے کہ آرڈر کی ادائیگی کیسے کی جاتی ہے:

آپ کے ڈپازٹ سے کچھ بھی نہیں کاٹا جاتا۔ ہر کامیاب آرڈر آپ کے اکاؤنٹ کے واجب الادا بیلنس میں آپ کے معاہدے میں متفقہ تصفیہ کی کرنسی میں شامل کیا جاتا ہے۔ آپ اپنے معاہدے کے مطابق انوائس کے ذریعے اس کی ادائیگی کرتے ہیں۔
آپ کے اکاؤنٹ کی ایک کریڈٹ حد ہے۔ جب تک واجب الادا رقم حد کے اندر ہے، صفر ڈپازٹ کے ساتھ بھی آرڈرز قبول کیے جاتے ہیں۔
صرف فراہم کردہ خدمات کا بل دیا جاتا ہے۔ وہ آرڈر جو مسترد ہو جائے یا جس پر عمل نہ کیا جائے اس کی کوئی قیمت نہیں ہوتی۔
اگر وصول کنندہ کے پتے کو فعال کرنا ضروری ہو، تو ایکٹیویشن اسی آرڈر کا حصہ ہے اور اس کا الگ چارج کے طور پر بل دیا جاتا ہے۔

پوسٹ پیڈ بلنگ درخواست پر کسی اکاؤنٹ کے لیے Netts کے ذریعے فعال کی جاتی ہے۔ ہر جواب آپ کو بتاتا ہے کہ آرڈر کی ادائیگی کیسے کی گئی ہے: paymentMode یا تو postpaid ہے یا prepaid۔

اضافی درخواست کے فیلڈز

Parameter	Type	مطلوب ہے	تفصیل
test	boolean	نہیں	`true` — صرف قیمت کا حساب لگائیں۔ کوئی آرڈر، ڈیلیوری یا بل نہیں بنایا جائے گا
freezePrice	boolean	نہیں	`true` — 60 سیکنڈ کے لیے اپنے معاہدے کے تحت قیمت فکس کریں۔ کوئی آرڈر یا بل نہیں بنایا جائے گا
quoteId	string	نہیں	`freezePrice` کی طرف سے جاری کردہ کوٹ کی قیمت پر آرڈر دیں
priceCurrency	string	نہیں	`TRX` (ڈیفالٹ) یا آپ کے معاہدے کی کرنسی، جیسا کہ `settlement.asset` میں ہے۔ پوسٹ پیڈ اکاؤنٹس کے لیے آپ کے معاہدے کی کرنسی میں رقوم ہمیشہ شامل ہوتی ہیں

quoteId کو test یا freezePrice کے ساتھ نہیں ملایا جا سکتا۔ درخواست کے باڈی میں کسی دوسرے فیلڈ کو مسترد کر دیا جاتا ہے۔

قیمت کی جانچ (`test: true`)

json

{
    "amount": 65000,
    "receiveAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "test": true
}

json

{
    "detail": {
        "code": 10010,
        "msg": "Test calculation",
        "data": {
            "amount": 65000,
            "unitPriceSun": "19",
            "discount": null,
            "energyTRX": "1.235000",
            "activationTRX": "1.100000",
            "wouldCostTRX": "2.335000",
            "paidTRX": 0,
            "paymentMode": "postpaid",
            "activationCheck": "inactive",
            "alt": {"USDC": {"energy": "0.409088", "activation": "0.364370", "total": "0.773458"}},
            "fxAt": "2026-10-19T07:16:12.548894+00:00"
        }
    }
}

Field	تفصیل
unitPriceSun	SUN میں فی Energy یونٹ قیمت، بشمول آپ کی ذاتی رعایت اگر آپ کے پاس ہو
discount	آپ کی ذاتی رعایت (`type`، `value`) یا `null`
energyTRX / activationTRX / wouldCostTRX	Energy، ایکٹیویشن (اگر پتے کو اس کی ضرورت ہو) اور کل، TRX میں
activationCheck	`inactive` — پتہ فعال کیا جائے گا اور بل کیا جائے گا؛ `active` — کوئی ایکٹیویشن نہیں؛ `unknown` — ابھی جانچ نہیں کی جا سکی
`alt.<currency>`	آپ کے معاہدے کی کرنسی میں وہی رقوم
fxAt	آپ کے معاہدے کی کرنسی میں رقوم کے لیے استعمال ہونے والی شرح مبادلہ کا وقت

فکسڈ قیمت کا کوٹ (`freezePrice: true`)

آرڈر کرنے سے پہلے اپنے معاہدے کے تحت قیمت فکس کرنے کے لیے کوٹ کا استعمال کریں۔

آرڈر کو "freezePrice": true کے ساتھ بھیجیں۔ جواب میں کوڈ 10011 (Quote issued)، قیمت کی جانچ کے جیسے فیلڈز، نیز quoteId اور expiresAt شامل ہوں گے۔
60 سیکنڈ کے اندر آرڈر کو "quoteId": "<quoteId>" اور اسی amount اور receiveAddress کے ساتھ بھیجیں۔
آرڈر کا بل کوٹ کی گئی قیمت پر دیا جائے گا — کوٹ کے وقت آپ کے معاہدے کے تحت جو قیمت تھی — چاہے قیمت اس دوران بدل ہی کیوں نہ جائے۔

ایک کوٹ کو ایک بار اور صرف اسی پروڈکٹ کے لیے استعمال کیا جا سکتا ہے: 5 منٹ کا کوٹ 1 گھنٹے کے آرڈر کی ادائیگی نہیں کر سکتا۔ ایک میعاد ختم یا پہلے سے استعمال شدہ کوٹ مسترد کر دیا جاتا ہے اور کچھ بھی آرڈر نہیں ہوتا ہے۔

json

{
    "amount": 65000,
    "receiveAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "quoteId": "q_4f540f16a2c94b7f8e3d1a6b5c0e9d72"
}

کامیاب آرڈر

json

{
    "detail": {
        "code": 10000,
        "msg": "Successful, 1.24 TRX service cost, postpaid",
        "data": {
            "orderId": "5M5f557d2fba",
            "paidTRX": 1.235,
            "hash": "c1fafd8ef7fb6b7fb8a729120756b26e611f401275cb4f7a04fe2bafd75b13da",
            "delegateAddress": "TR3qZsdmkFcvP729Md3PwXzktFQkMoUzjg",
            "energy": 65000,
            "paymentMode": "postpaid",
            "energyTRX": "1.235000",
            "activationTRX": "0.000000",
            "totalTRX": "1.235000"
        }
    }
}

Field	تفصیل
paidTRX	TRX میں سروس کی لاگت۔ پوسٹ پیڈ اکاؤنٹس کے لیے یہ ڈپازٹ سے کٹوتی نہیں کی جاتی
paymentMode	`postpaid`
energyTRX / activationTRX / totalTRX	درست رقوم، 6 اعشاریہ مقامات تک
quoteId, alt	تب موجود ہوتے ہیں جب آرڈر کوٹ کے ساتھ دیا گیا تھا: کوٹ ID اور کوٹ کی گئی رقوم

باقی تمام فیلڈز پری پیڈ آرڈرز کی طرح ہی ہیں۔

کریڈٹ کی حد ختم ہو گئی (402)

json

{
    "detail": {
        "code": 1004,
        "msg": "Postpaid credit limit reached.",
        "paymentMode": "postpaid",
        "reason": "limit_reached"
    }
}

آرڈر پر عمل نہیں کیا جاتا اور کچھ بھی بل نہیں کیا جاتا۔ آپ کی ادائیگی رجسٹر ہونے یا آپ کی حد بڑھنے کے بعد نئے آرڈرز دوبارہ قبول کیے جاتے ہیں۔

پوسٹ پیڈ خرابی کے کوڈز

Code	HTTP	تفصیل
`10010`	200	قیمت کی جانچ کا نتیجہ (`test`)
`10011`	200	کوٹ جاری کر دیا گیا (`freezePrice`)
`1004`	402	پوسٹ پیڈ کریڈٹ کی حد ختم ہو گئی
`4100`	400	غلط درخواست
`4101`	400	غیر تعاون یافتہ `priceCurrency`
`4102`	400	`quoteId` کو `test` یا `freezePrice` کے ساتھ ملایا گیا ہے
`4103`	409	کوٹ پہلے ہی استعمال ہو چکا ہے
`4104`	409	کوٹ کی میعاد ختم ہو چکی ہے
`4105`	409	ایڈیمپوٹینسی کلید پہلے ہی ایک مختلف درخواست کے لیے استعمال ہو چکی ہے
`4106`	404	کوٹ نہیں ملا
`4107`	409	آرڈر کے پیرامیٹرز کوٹ سے مختلف ہیں
`4108`	400	غلط `quoteId` فارمیٹ
`4109`	422	ذیلی اکاؤنٹس کے لیے دستیاب نہیں ہے
`5032`	503	قیمت عارضی طور پر دستیاب نہیں ہے
`5033`	503	شرح مبادلہ عارضی طور پر دستیاب نہیں ہے
`5034`	503	بلنگ عارضی طور پر دستیاب نہیں ہے — آرڈر قبول نہیں کیا گیا تھا
`5036`	503	کریڈٹ کی جانچ عارضی طور پر دستیاب نہیں ہے — بعد میں دوبارہ کوشش کریں

اوپر دی گئی تمام 4xx اور 503 جوابات کے لیے کچھ بھی آرڈر نہیں کیا جاتا اور نہ ہی کوئی بل بنایا جاتا ہے۔

نوٹس

کامیاب آرڈر پر Energy فوری طور پر فراہم کر دی جاتی ہے (عام طور پر 0.5-2 سیکنڈ کے اندر)
API جواب کا ٹائم آؤٹ: زیادہ سے زیادہ 10 سیکنڈ (اندرونی دوبارہ کوششوں پر مشتمل ہے)
پتہ کی ایکٹیویشن: اگر وصول کنندہ کا پتہ فعال نہیں ہے، تو Netts اسے لاگت کی قیمت پر فعال کرتا ہے۔ ایکٹیویشن کی قیمت فی پتہ صرف ایک بار وصول کی جاتی ہے
مدت: مقررہ 5 منٹ (300 سیکنڈ)
کم از کم Energy کی مقدار: 61,000 یونٹس
زیادہ سے زیادہ Energy کی مقدار: 650,000 یونٹس فی آرڈر
Energy بفر: +50 یونٹس خودکار طور پر شامل کیے جاتے ہیں (مفت)
آرڈر ID فارمیٹ: یکساں ٹریکنگ کے لیے 5M{id}
قیمت کا تعین: Pricing API کے ذریعے دن کے وقت کے لحاظ سے متحرک
ریٹ کی حد بندی: 50 درخواستیں فی سیکنڈ فی IP پتہ
صرف اندرونی پولز: اگر پولز میں گنجائش ختم ہو جائے، تو تھوڑی تاخیر کے بعد دوبارہ کوشش کریں یا متبادل کے طور پر 1 گھنٹے کے اینڈ پوائنٹ کا استعمال کریں

POST /apiv2/order5m ​

اینڈ پوائنٹ URL ​

درخواست کے ہیڈرز ​

درخواست کا باڈی ​

درخواست کے پیرامیٹرز ​

فراہم کنندہ کی معلومات ​

مثالیں ​

cURL ​

Python ​

جواب ​

کامیابی کا جواب (200 OK) ​

پتہ کی ایکٹیویشن کے ساتھ کامیابی (200 OK) ​

جواب کے فیلڈز ​

خرابی کے جوابات ​

غلط Energy کی مقدار (400) ​

تصدیق کی خرابی (401) ​

ناکافی بیلنس (403) ​

سروس دستیاب نہیں ہے (503) ​

اندرونی سرور کی خرابی (500) ​

خرابی کے کوڈز کا حوالہ ​

شرح کی حدود ​

شرح کی حد کے ہیڈرز ​

شرح کی حد سے تجاوز (429) ​

ایڈیمپوٹینسی (Idempotency) ​

ایڈیمپوٹینسی کیسے کام کرتی ہے ​

اپنی خود کی کلید فراہم کرنا ​

دو ایک جیسے آرڈرز دینا ​

ڈپلیکیٹ درخواستوں کے لیے HTTP اسٹیٹس کوڈز ​

ڈپلیکیٹ درخواست - پہلے ہی کارروائی ہو چکی ہے (208) ​

ڈپلیکیٹ درخواست - ابھی کارروائی جاری ہے (409) ​

بہترین طریقہ کار ​

موازنہ: 5 منٹ بمقابلہ 1 گھنٹے کے آرڈرز ​

پوسٹ پیڈ اکاؤنٹس ​

اضافی درخواست کے فیلڈز ​

قیمت کی جانچ (test: true) ​

فکسڈ قیمت کا کوٹ (freezePrice: true) ​

کامیاب آرڈر ​

کریڈٹ کی حد ختم ہو گئی (402) ​

پوسٹ پیڈ خرابی کے کوڈز ​

نوٹس ​

POST /apiv2/order5m

اینڈ پوائنٹ URL

درخواست کے ہیڈرز

درخواست کا باڈی

درخواست کے پیرامیٹرز

فراہم کنندہ کی معلومات

مثالیں

cURL

Python

جواب

کامیابی کا جواب (200 OK)

پتہ کی ایکٹیویشن کے ساتھ کامیابی (200 OK)

جواب کے فیلڈز

خرابی کے جوابات

غلط Energy کی مقدار (400)

تصدیق کی خرابی (401)

ناکافی بیلنس (403)

سروس دستیاب نہیں ہے (503)

اندرونی سرور کی خرابی (500)

خرابی کے کوڈز کا حوالہ

شرح کی حدود

شرح کی حد کے ہیڈرز

شرح کی حد سے تجاوز (429)

ایڈیمپوٹینسی (Idempotency)

ایڈیمپوٹینسی کیسے کام کرتی ہے

اپنی خود کی کلید فراہم کرنا

دو ایک جیسے آرڈرز دینا

ڈپلیکیٹ درخواستوں کے لیے HTTP اسٹیٹس کوڈز

ڈپلیکیٹ درخواست - پہلے ہی کارروائی ہو چکی ہے (208)

ڈپلیکیٹ درخواست - ابھی کارروائی جاری ہے (409)

بہترین طریقہ کار

موازنہ: 5 منٹ بمقابلہ 1 گھنٹے کے آرڈرز

پوسٹ پیڈ اکاؤنٹس

اضافی درخواست کے فیلڈز

قیمت کی جانچ (`test: true`)

فکسڈ قیمت کا کوٹ (`freezePrice: true`)

کامیاب آرڈر

کریڈٹ کی حد ختم ہو گئی (402)

پوسٹ پیڈ خرابی کے کوڈز

نوٹس