marketplace

POST /v1/marketplace/purchases/{sale_id}/revision

Send the delivery back, and say what is wrong.

تمام marketplace اینڈ پوائنٹس

توثيقِ شناخت

ایک API کلید بطور بیر ٹوکن (bearer token) ارسال کریں۔ یہ اینڈ پوائنٹ اسپیسیفیکیشن میں کسی مخصوص اجازت کا ذکر نہیں کرتا، اس لیے فرض کرنے کے بجائے اپنی کلید کو کم از کم درکار اجازت دیں اور رسپانس چیک کریں۔

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

آزمائیں

کوئی بھی چیز جو زاویہ دار قوسین میں ہو اسے اپنی اقدار سے بدلیں، اور کلیدی پلیس ہولڈر کو اپنے ڈیش بورڈ کی کسی کلید سے بدلیں۔

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

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

تفصیلات

docs/82 §3. Not accepting is a **first-class path**, not an error state, and it **pauses the acceptance clock** — so a seller cannot run the timer out by stalling, and a buyer who did engage is never auto-accepted for a delivery they rejected. The reason is required and becomes part of the order record, visible to the seller: a rejection they cannot read is an instruction to change something unnamed, which produces a second rejection. Bounded by the package's `revisions_included`, which is a term the buyer paid for rather than an unlimited entitlement — exceeding it points at a dispute, which has staff in it. A package promising **zero** revisions still allows the first request, because the alternative to it is a chargeback.

پیرامیٹرز

نامقسملازمییہ کیا ہے
sale_id (path)stringہاں

درخواست کا باڈی

نامقسملازمییہ کیا ہے
reasonstringہاںWhat needs changing. Required, and shown to the seller — a rejection they cannot read names nothing, so it produces a second rejection.

جواب

نامقسملازمییہ کیا ہے
idUuidہاںUUIDv7 identifier — sortable by creation time (docs/02 §8).
stateMarketplaceSaleStateہاںWhere one purchased package is in its life (docs/82 §3). The terminal state is `accepted`, not `delivered`: delivery is the vendor's claim, acceptance is the buyer's act, and it…
listing_idUuidہاںUUIDv7 identifier — sortable by creation time (docs/02 §8).
listing_titlestringہاں
package_namestringہاں
package_descriptionstringنہیں
vendor_display_namestringنہیںThe seller's public name, never the legal name held for identity checks.
delivery_daysintegerنہیں
revisions_includedintegerنہیں
revision_countintegerنہیں
billing_modeMarketplaceBillingModeنہیںHow an offer is charged (docs/82 §2a). A property of the OFFER, chosen by the seller from what the listing type permits — a $200 one-off audit and $150/month of link building si…
billing_intervalobjectنہیں
period_indexintegerنہیں0 for a one-time sale and a subscription's first period; one per renewal.
amount_minorintegerہاں
currencyCurrencyCodeہاںISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
auto_acceptsbooleanنہیںRead this BEFORE `accept_by`. A null `accept_by` means two completely different things — not delivered yet, or this type never auto-accepts at all (an asset sale releasing on a…
auto_accept_daysobjectنہیں
accept_byobjectنہیںWhen this purchase auto-accepts if the buyer does nothing.
delivered_atobjectنہیں
accepted_atobjectنہیں
accepted_automaticallybooleanنہیںWhether the timer accepted this rather than the buyer. It does NOT change the outcome — auto-accept has the same finality as the button, which is why the buyer must be warned be…
last_revision_reasonstringنہیں
last_revision_atobjectنہیں
order_idUuidنہیںUUIDv7 identifier — sortable by creation time (docs/02 §8).
created_atstringنہیں

وہ خرابیان جو یہ اینڈ پوائنٹ واپس کر سکتا ہے

401 · 404 · 422