extras

GET /v1/extra-purchases/{purchaseId}

Get an extra purchase.

සියලුම extras අන්ත ලක්ෂ්‍ය

සත්‍යාපනය

බෙරර් ටෝකනයක් ලෙස API යතුරක් යවන්න. යතුරෙහි billing.view අවසරය තිබිය යුතුය; එය නොමැති යතුරක් 404 ලෙස නොව 403 ලෙස ප්‍රතික්ෂේප කෙරේ.

මෙම අවසාන ලක්ෂ්‍යය සඳහා සංවිධාන හැඳුනුම්පතක් (organisation id) අවශ්‍ය නොවේ. ඔබගේ යතුර මඟින් එය අයත් වන සංවිධානය දැනටමත් හඳුනා ගන්නා අතර, ප්‍රතිචාරය ඒ වෙත සීමා වේ.

උත්සාහ කරන්න

<අගයන්> සමඟ කෝණික වරහන් තුළ ඇති ඕනෑම දෙයක් සහ ඔබේ උපකරණ පුවරුවෙන් ලබාගත් යතුරක් සමඟ key ස්ථාන දායකය ප්‍රතිස්ථාපනය කරන්න.

curl -X GET https://api.zinndigital.com/v1/extra-purchases/{purchaseId} \
  -H "Authorization: Bearer zdk_live_…"

පද්ධතියට පිවිස සිටිනවාද? ඔබගේ උපකරණ පුවරුවේ ඇති API කොන්සෝලය මඟින් ඔබේ සැබෑ ආයතනික හැඳුනුම්පත සහ ඔබේම යතුර පුරවා, සජීවී API වෙත ඉල්ලීම ක්‍රියාත්මක කරන බැවින් ඔබට සැබෑ ප්‍රතිචාරය දැකගත හැක. මෙම අග්‍රලක්ෂ්‍යය API කොන්සෝලය තුළ විවෘත කරන්න

විස්තර

Returns one extra purchase in scope with its status and outcome. Requires `billing.view`.

පරාමිතීන්

නමවර්ගයඅත්‍යවශ්‍යයිඑය කුමක්ද
purchaseId (path)Uuidඔව්The extra purchase's id.

පsspil

නමවර්ගයඅත්‍යවශ්‍යයිඑය කුමක්ද
idUuidඔව්UUIDv7 identifier — sortable by creation time (docs/02 §8).
org_idUuidඔව්UUIDv7 identifier — sortable by creation time (docs/02 §8).
extra_idUuidඔව්UUIDv7 identifier — sortable by creation time (docs/02 §8).
site_idobjectනැත
domain_idobjectනැත
statusExtraPurchaseStatusඔව්An extra purchase's lifecycle state.
categorystringඔව්
fulfilment_typeExtraFulfilmentTypeඔව්How an extra is delivered.
intervalExtraIntervalඔව්One-off charge or a recurring subscription.
priceMoneyAmountඔව්A money value — integer minor units + an ISO 4217 code (CLAUDE.md §2.8).
recurrencestring<none, active, ended>ඔව්Whether the recurrence behind this purchase is still live. `none` = it never recurred (a one-off); `active` = a scheduled charge exists; `ended` = it recurred and no longer does…
next_renewal_onobjectනැතThe next charge date, or `null`. Also `null` for a live charge that has no date scheduled yet, so read `recurrence` — not this field — to decide whether a purchase renews at all.
sla_due_atobjectනැත
completed_atobjectනැත
failure_reasonstringනැත
created_atstringඔව්
updated_atstringඔව්

මෙම අවසාන ලක්ෂ්‍යය ආපසු ලබා දිය හැකි දෝෂ

401 · 403 · 404 · 429