commerce
GET /v1/orders/{orderId}/refund-eligibility
Preview an order's refund eligibility.
Doğrulama
API açarını bearer token kimi göndərin. Açar billing.view icazəsinə malik olmalıdır; bu icazəsi olmayan açar 404 deyil, 403 xətası ilə rədd edilir.
Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.
Sınaqdan keçir
Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.
curl -X GET https://api.zinndigital.com/v1/orders/{orderId}/refund-eligibility \
-H "Authorization: Bearer zdk_live_…"Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın
Təfərrüatlar
The refund policy's decision for this order without opening a request — whether it is eligible, the amount that would be refunded, and whether it needs staff approval (docs/05 §4.13). Requires `billing.view`.
Parametrlər
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
orderId (path) | Uuid | Bəli | The order's id. |
Cavab
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
eligible | boolean | Bəli | — |
policy_class | RefundPolicyClass | Bəli | How the refund policy classified a request (captured at request time). |
requires_approval | boolean | Bəli | — |
auto_approved | boolean | Bəli | Eligible and needs no human — the money-back path issues immediately. |
amount | MoneyAmount | Bəli | A money value — integer minor units + an ISO 4217 code (CLAUDE.md §2.8). |
reason | string | Bəli | A customer-safe explanation of the decision. |
Bu son nöqtənin qaytara biləcəyi xətalar
401 · 403 · 404 · 429