پرش به مستندات
API

فهرست پرداخت‌ها

هر پرداخت فضای کاری، هرکدام با فاکتورش.

GET/billing/invoices

فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.

GET /billing/invoices

هر پرداخت فضای کاری، هرکدام با فاکتورش.

نمونه

به billing:read نیاز دارد. همان سابقه در طرح‌ها و صورت‌حساب است. page و limit میان پرداخت‌ها ورق می‌زنند، sort برابر newest یا oldest است، و search طرح، شمارهٔ فاکتور، شناسهٔ پرداخت و نام صورت‌حساب را جست‌وجو می‌کند.

curl
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 است.

مرجع