API
فهرست پرداختها
هر پرداخت فضای کاری، هرکدام با فاکتورش.
GET/billing/invoices
فراخوانی واقعی را روی فضای کاری شما اجرا میکند.
GET /billing/invoices
هر پرداخت فضای کاری، هرکدام با فاکتورش.
نمونه
به billing:read نیاز دارد. همان سابقه در طرحها و صورتحساب است. page و limit میان پرداختها ورق میزنند، sort برابر newest یا oldest است، و search طرح، شمارهٔ فاکتور، شناسهٔ پرداخت و نام صورتحساب را جستوجو میکند.
curl "$OE/billing/invoices?limit=10" -H "$AUTH"{ "object": "list", "data": [ { "object": "invoice", "id": "8c51f0d2-3b7e-4a19-b6c4-0e9d2f7a1c38", "createdAt": "2026-10-01T09:00:12.000Z", "amountCents": 10000, "subtotalCents": 10000, "currency": "usd", "status": "paid", "paid": true, "reason": "subscription_cycle", "invoiceNumber": "ACME-0007", "invoiceReady": true, "needsBillingDetails": false, "billingName": "Acme Ltd", "product": "Business", "payAsYouGo": false, "discount": null } ], "total": 7, "page": 1, "limit": 10, "hasMore": false, "metered": true}needsBillingDetails یعنی فاکتور اول به نام و نشانی صورتحساب نیاز دارد، که PUT /billing/invoices/{orderId}/details آنها را ذخیره میکند.
فقط مالک فضای کاری به صورتحساب میرسد: یک کلید API، یا توکن دسترسیای که مالک با همهٔ نشانیها وصل کرده. توکن یک عضو 403 owner_only است، و کلید یا توکنی که به نشانیها یا دامنههای خاصی محدود است 422 capability_unsupported است.