marketplace

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

Send the delivery back, and say what is wrong.

Բոլոր marketplace վերջնակետերը

Նույնականացում

Ուղարկեք API բանալին որպես bearer թոքեն։ Այս վերջնակետը բնութագրում չի նշում որոշակի թույլտվության մասին, ուստի տվեք ձեր բանալուն նվազագույն անհրաժեշտը և ենթադրություններ անելու փոխարեն ստուգեք պատասխանը:

Այս վերջնակետը կազմակերպության ID չի ընդունում: Ձեր բանալին արդեն իսկ նույնականացնում է այն կազմակերպությունը, որին պատկանում է, և պատասխանը սահմանափակված է դրանով:

Փորձել

Փոխարինեք անկյունային փակագծերում գտնվող ցանկացած բան ձեր սեփական արժեքներով, և բանալու տեղապահը՝ ձեր վահանակի բանալիով:

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 վահանակը լրացնում է ձեր իրական կազմակերպության ID-ն և ձեր սեփական բանալին և գործարկում է հարցումը ուղիղ 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