ادائیگی کو انوائس سے منسلک کریں

جائزہ

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

منسلک کرنے کی شرائط

منسلک کرنا صرف اس وقت کامیاب ہوتا ہے جب تمام شرائط ایک ساتھ پوری ہوں:

1. انوائس کا اسٹیٹس — unpaid یا expired۔ منسوخ اور پہلے سے ادا شدہ انوائسز سے کوئی ادائیگی منسلک نہیں ہو سکتی۔ منسوخی ناقابل واپسی ہے۔
2. ادائیگی ابھی کسی دوسری انوائس سے منسلک نہیں۔ ایک ادائیگی صرف ایک انوائس سے منسلک ہو سکتی ہے۔
3. ادائیگی اس والٹ پر آئی ہے جو اس انوائس میں شامل ہے۔
4. ادائیگی دستیاب ادائیگی کی مدت میں آتی ہے — انوائس بننے سے 24 گھنٹے پہلے سے 24 گھنٹے بعد تک۔ انوائس بننے سے پہلے آنے والی ادائیگی منسلک ہو سکتی ہے؛ مدت سے باہر والی نہیں۔

اگر انوائس کسی دوسرے پروجیکٹ کی ہے اور کلید کسی پروجیکٹ تک محدود ہے، تو میتھڈ Restricted project کے ساتھ جواب دیتا ہے۔ اگر کوئی اور شرط پوری نہ ہو، تو وجہ بتائے بغیر ایک عمومی غلطی واپس آتی ہے — شرائط اپنی طرف جانچیں۔

منسلک کرنے کے بعد کیا ہوتا ہے

• انوائس ادا شدہ (Paid) اسٹیٹس میں چلی جاتی ہے۔
• اطلاعات ای میل، Telegram بوٹ اور Webhook URL پر جاتی ہیں — بالکل خودکار طور پر منسلک کرنے کی طرح۔
• سروس انوائس کی رقم invoice.amountFiatUSD کو اصل میں موصول ہونے والی رقم سے بدل دیتی ہے، جو منسلک کرنے کے لمحے کی شرح تبادلہ پر USD میں تبدیل ہوتی ہے۔ invoice.amountFiat میں اصل رقم نہیں بدلتی۔
• سروس فیس آپ کو موصول ہونے والی رقم پر پروجیکٹ کی فیس کی شرح سے دوبارہ شمار ہوتی ہے۔ زائد ادائیگی پر یہ انوائس بنتے وقت کے حساب سے زیادہ ہوتی ہے؛ کم ادائیگی پر کم۔

درخواست

curl -X POST https://api.bitsby.app/invoices/bindPayment \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "invoiceId=ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c" \
	-F "paymentId=a4c9e2ee-9a03-43e5-a1a1-00caf679d16a"

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

پیرامیٹر	ڈیٹا کی قسم	تفصیل	مثال	لازمی؟
invoiceId	UUID	UUID فارمیٹ میں انوائس ID	ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c	ہاں
paymentId	UUID	UUID فارمیٹ میں ادائیگی کی ID	a4c9e2ee-9a03-43e5-a1a1-00caf679d16a	ہاں

جواب کی مثال

{
   "result":"success",
   "data":"Invoice binded to payment"
}