भुगतान को इनवॉइस से जोड़ें

अवलोकन

ज़्यादातर मामलों में ग्राहक आपके क्रिप्टो वॉलेट में ठीक वही राशि चुकाते हैं, जो इनवॉइस में लिखी है। लेकिन कभी-कभी ग्राहक ग़लती करता है और आरक्षित राशि से अलग कुछ चुकाता है। ऐसे में सेवा भुगतान को इनवॉइस से अपने-आप नहीं जोड़ सकती और इनवॉइस को भुगतान हुआ नहीं मान सकती। ऐसा होने पर आप, व्यापारी के तौर पर, भुगतान को इनवॉइस से मैन्युअल रूप से जोड़ सकते हैं, बशर्ते आपको पक्का पता हो कि आप किस भुगतान का इंतज़ार कर रहे थे। यह डैशबोर्ड में या 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"
}