चार्जबैक

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

आपके 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 — किसी निर्दिष्ट लेनदेन के लिए चार्जबैक समीक्षा का अनुरोध करता है।

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",
  "documents": [
    { "label": "FILE_NAME", "data": "JVBERi0xLjQKMSAwI==" }
  ]
}

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

200 OK

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

फ़ील्ड	विवरण
id	जनरेट की गई चार्जबैक ID।

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

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

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	चार्जबैक की वर्तमान स्थिति।

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