चार्जबैक

Markdown

शुरू करने से पहले

आपके API अनुरोध access token का उपयोग करके प्रमाणित किए जाते हैं। कोई भी अनुरोध जिसमें वैध access token शामिल नहीं है, त्रुटि लौटाएगा। अधिक जानें प्रमाणीकरण में।

Base URL

• UAT: https://transactions.transactional.uat.unico.app/api/public/v1
• Production: https://transactions.transactional.unico.app/api/public/v1

चार्जबैक की रिपोर्ट करें

POST /credit/transactions/{transaction_id}/chargeback — Unico को सूचित करता है कि किसी निर्दिष्ट लेनदेन के लिए चार्जबैक प्राप्त हुआ है।

रिपोर्ट करना विवाद दर्ज करना नहीं है

यह endpoint केवल चार्जबैक की रिपोर्ट करता है। यह चार्जबैक विश्लेषण नहीं खोलता और दायित्व गारंटी को सक्रिय नहीं करता। Unico से चार्जबैक का विश्लेषण करवाने के लिए, पोर्टल में लेनदेन के लिए विवाद दर्ज करें।

Headers

Header	मान
Authorization	Bearer {token} — एक वैध access token।

Body

{
  "datetime": "2023-01-05T03:00:00.000Z",
  "requestor": { "key": "cpf", "value": "USER_CPF" },
  "name": "USER_NAME",
  "reason": "REQUEST_REASON",
  "observation": "GENERAL_OBSERVATIONS"
}

फ़ील्ड	प्रकार	आवश्यक	विवरण
datetime	string	हां	चार्जबैक प्राप्त होने की तिथि और समय, ISO 8601 फ़ॉर्मेट।
requestor	object	हां	अनुरोधकर्ता की जानकारी।
requestor.key	string	हां	अनुरोधकर्ता के लिए पहचान की का प्रकार (जैसे cpf)।
requestor.value	string	हां	अनुरोधकर्ता के लिए पहचान की का मान।
name	string	हां	अनुरोधकर्ता का नाम।
reason	string	हां	चार्जबैक का कारण।
observation	string	नहीं	चार्जबैक के बारे में सामान्य टिप्पणियां।

201 Created

{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0"
}

फ़ील्ड	विवरण
id	चार्जबैक ID।

एक लेनदेन का केवल एक ही चार्जबैक होता है। जिस लेनदेन का पहले से एक चार्जबैक है, उसकी रिपोर्ट करने पर मौजूदा चार्जबैक की id के साथ 200 OK लौटाया जाता है, और उसमें कोई बदलाव नहीं होता।

त्रुटि प्रतिक्रियाओं के लिए, देखें त्रुटियां — लेनदेन निर्माण।

चार्जबैक की स्थिति प्राप्त करें

GET /credit/transactions/{transaction_id}/chargeback/{chargeback_id} — किसी विशिष्ट चार्जबैक की स्थिति जांचता है।

Headers

Header	मान
Authorization	Bearer {token} — एक वैध access token।

200 OK

{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "status": "waiting"
}

फ़ील्ड	विवरण
id	चार्जबैक ID।
status	चार्जबैक की वर्तमान स्थिति।

रिपोर्ट किया गया चार्जबैक waiting स्थिति में रहता है। यदि पोर्टल में लेनदेन पर विवाद दर्ज किया जाता है, तो वही id विश्लेषण की प्रगति और परिणाम दिखाती है। सभी संभावित स्थितियों के लिए सूचीबद्ध मान — चार्जबैक परिणाम देखें। परफॉर्मेंस को ऑप्टिमाइज़ करने के लिए, इस endpoint को पोल करने के बजाय Webhook लागू करें।