marketplace

POST `/v1/marketplace/orders/{sale_id}/dispute`

The buyer disputes an order — stops the acceptance clock and holds the payout.

प्रमाणीकरण

एपिआई कुञ्जीलाई बियरर टोकन (bearer token) को रूपमा पठाउनुहोस्। यो इन्डपोइन्टले विशिष्ट अनुमति खुलाएको छैन, त्यसैले अनुमान गर्नुको सट्टा आफ्नो कुञ्जीलाई आवश्यक पर्ने न्यूनतम अधिकार दिनुहोस् र प्रतिक्रिया जाँच गर्नुहोस्।

यो इन्डपोइन्टले कुनै संस्थाको आइडी लिँदैन। तपाईंको कुञ्जीले यस अन्तर्गत पर्ने संस्थालाई पहिल्यै पहिचान गर्छ, र प्रतिक्रिया त्यसैमा सीमित हुन्छ।

प्रयास गर्नुहोस्

कोणीय कोष्ठकभित्र भएका जुनसुकै कुरालाई आफ्नो मानहरूद्वारा बदल्नुहोस्, र मुख्य स्थानहोल्डरलाई तपाईंको ड्यासबोर्डको कुञ्जीद्वारा बदल्नुहोस्।

curl -X POST https://api.zinndigital.com/v1/marketplace/orders/{sale_id}/dispute \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "reason": <string> }'

लगइन गर्नुभएको छ? तपाईंको ड्यासबोर्डमा रहेको API कन्सोलले तपाईंको वास्तविक संस्थाको आईडी र आफ्नै कुञ्जी भरिदिन्छ, र लाइभ API विरुद्ध अनुरोध चलाउँछ ताकि तपाईंले वास्तविक प्रतिक्रिया हेर्न सक्नुहोस्। यो एन्डपोइन्टलाई API कन्सोलमा खोल्नुहोस्

विवरणहरू

Buyer only (a seller receives 404). A reason is required. The sale moves to disputed, the auto-accept deadline is cleared, no path can release the seller's payable until staff decide, and the seller, the buyer and marketplace staff are notified.

प्यारामिटरहरू

नाम	प्रकार	आवश्यक	यो के हो
`sale_id (path)`	`string`	हुन्छ	—

अनुरोध बडी

नाम	प्रकार	आवश्यक	यो के हो
`reason`	`string`	हुन्छ	—

प्रतिक्रिया

नाम	प्रकार	आवश्यक	यो के हो
`sale_id`	`string`	हुन्छ	—
`state`	`string`	हुन्छ	—
`is_buyer`	`boolean`	हुन्छ	—
`can_raise`	`boolean`	हुन्छ	—
`refusal_code`	`object`	हुन्छ	—
`dispute`	`object`	हुन्छ	—

यो इन्डपोइन्टले फर्काउन सक्ने त्रुटिहरू

401 · 404 · 422

POST /v1/marketplace/orders/{sale_id}/dispute