marketplace

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

Send the delivery back, and say what is wrong.

Vituo vyote vya marketplace

Uthibitishaji

Tuma ufunguo wa API kama tokeni ya kubeba. Sehemu hii ya mwisho haitaji ruhusa maalum katika maelezo, kwa hivyo ipe ufunguo wako kiwango cha chini kabisa kinachohitajika na uangalie jibu badala ya kukisia.

Endpoint hii haichukui kitambulisho cha shirika. Ufunguo wako tayari unalitambua shirika linalohusika, na jibu limewekewa kikomo kwa shirika hilo pekee.

Jaribu

Badilisha chochote kilicho ndani ya mabano ya pembe na maadili yako mwenyewe, na kishikiliaji cha ufunguo na ufunguo kutoka kwa dashibodi yako.

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

Umeingia kwenye akaunti? Dashibodi yako ya kiweko cha API inajaza kitambulisho chako halisi cha shirika na ufunguo wako mwenyewe, na kuendesha ombi dhidi ya API ya moja kwa moja ili uweze kuona jibu halisi. Fungua sehemu hii ya mwisho (endpoint) kwenye konsole ya API

Maelezo

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.

Vigezo

JinaAinaInayohitajikaKilicho hiki
sale_id (path)stringNdiyo

Mwili wa ombi

JinaAinaInayohitajikaKilicho hiki
reasonstringNdiyoWhat needs changing. Required, and shown to the seller — a rejection they cannot read names nothing, so it produces a second rejection.

Majibu

JinaAinaInayohitajikaKilicho hiki
idUuidNdiyoUUIDv7 identifier — sortable by creation time (docs/02 §8).
stateMarketplaceSaleStateNdiyoWhere 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_idUuidNdiyoUUIDv7 identifier — sortable by creation time (docs/02 §8).
listing_titlestringNdiyo
package_namestringNdiyo
package_descriptionstringHapana
vendor_display_namestringHapanaThe seller's public name, never the legal name held for identity checks.
delivery_daysintegerHapana
revisions_includedintegerHapana
revision_countintegerHapana
billing_modeMarketplaceBillingModeHapanaHow 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_intervalobjectHapana
period_indexintegerHapana0 for a one-time sale and a subscription's first period; one per renewal.
amount_minorintegerNdiyo
currencyCurrencyCodeNdiyoISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
auto_acceptsbooleanHapanaRead 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_daysobjectHapana
accept_byobjectHapanaWhen this purchase auto-accepts if the buyer does nothing.
delivered_atobjectHapana
accepted_atobjectHapana
accepted_automaticallybooleanHapanaWhether 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_reasonstringHapana
last_revision_atobjectHapana
order_idUuidHapanaUUIDv7 identifier — sortable by creation time (docs/02 §8).
created_atstringHapana

Hitilafu ambazo mwisho huu unaweza kurudisha

401 · 404 · 422