GET and POST /api/billing/invoices — list and request invoices

Two operations on the invoice collection: list every invoice on the account, or request a new one for a paid China-site payment. Invoices are idempotent per payment_id; requesting one twice returns the same record.

Invoices apply to the China site only. On the international site, use receipts instead.

GET /api/billing/invoices

Auth: Session Bearer

Response

object[]

Show invoice

string

Invoice identifier.

string

Backing payment ID.

string

Invoice header (buyer name).

string

Buyer tax ID.

number

Invoiced amount.

string

CNY.

string

issued or pending.

string

ISO 8601 timestamp.

POST /api/billing/invoices

Auth: Session Bearer

Request

string

required

Paid payment to invoice.

string

required

Invoice header (buyer name in Chinese).

string

Optional buyer tax ID (统一社会信用代码).

Response

Returns the created invoice with the same shape as the GET response.

Example

curl -X POST https://ariacompute.cn/api/billing/invoices \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "Content-Type: application/json" \
  -d '{
    "payment_id": "pay_01H...",
    "title": "北京某某科技有限公司",
    "tax_id": "91110000..."
  }'

Errors

Status	Meaning
`400`	Missing field.
`401`	Missing or invalid session token.
`404`	Payment not found or not paid.
`409`	Invoice already exists for this payment (idempotent conflict, returns existing record).

⌘I

Overview

Authentication

API Keys

Models

Downloads

Billing

Site

GET and POST /api/billing/invoices — list and request invoices

GET /api/billing/invoices

Response

POST /api/billing/invoices

Request

Response

Example

Errors

​GET /api/billing/invoices

​Response

​POST /api/billing/invoices

​Request

​Response

​Example

​Errors

GET /api/billing/invoices

Response

POST /api/billing/invoices

Request

Response

Example

Errors