marketplace

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

Send the delivery back, and say what is wrong.

Minden marketplace végpont

Hitelesítés

Küldjön egy API-kulcsot bearer tokenként. Ez a végpont nem határoz meg konkrét jogosultságot a specifikációban, ezért adja meg a kulcsnak a legkevesebbet, amire szüksége van, és a feltételezés helyett ellenőrizze a választ.

Ez a végpont nem fogad el szervezeti azonosítót. Az Ön kulcsa már azonosítja azt a szervezetet, amelyhez tartozik, és a válasz is erre vonatkozik.

Próbálja ki

Cserélje ki a hegyes zárójelek közötti részt a saját értékeivel, a kulcshelyőrzőt pedig a vezérlőpultján található kulccsal.

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> }'

Be van jelentkezve? A vezérlőpultban lévő API-konzol kitölti a valós szervezetazonosítóját és a saját kulcsát, és a kérést az éles API-n futtatja, hogy láthassa a tényleges választ. Nyissa meg ezt a végpontot az API konzolban

Részletek

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.

Paraméterek

NévTípusKötelezőMi ez
sale_id (path)stringIgen

Kérés törzse

NévTípusKötelezőMi ez
reasonstringIgenWhat needs changing. Required, and shown to the seller — a rejection they cannot read names nothing, so it produces a second rejection.

Válasz

NévTípusKötelezőMi ez
idUuidIgenUUIDv7 identifier — sortable by creation time (docs/02 §8).
stateMarketplaceSaleStateIgenWhere 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_idUuidIgenUUIDv7 identifier — sortable by creation time (docs/02 §8).
listing_titlestringIgen
package_namestringIgen
package_descriptionstringNem
vendor_display_namestringNemThe seller's public name, never the legal name held for identity checks.
delivery_daysintegerNem
revisions_includedintegerNem
revision_countintegerNem
billing_modeMarketplaceBillingModeNemHow 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_intervalobjectNem
period_indexintegerNem0 for a one-time sale and a subscription's first period; one per renewal.
amount_minorintegerIgen
currencyCurrencyCodeIgenISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
auto_acceptsbooleanNemRead 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_daysobjectNem
accept_byobjectNemWhen this purchase auto-accepts if the buyer does nothing.
delivered_atobjectNem
accepted_atobjectNem
accepted_automaticallybooleanNemWhether 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_reasonstringNem
last_revision_atobjectNem
order_idUuidNemUUIDv7 identifier — sortable by creation time (docs/02 §8).
created_atstringNem

Hibák, amelyeket ez a végpont visszaadhattatlan

401 · 404 · 422