履約財務

可用性: Sandbox / Gateway MOCK is live.

MethodPathPurpose
GET/v1/fulfillment/balanceGet Fulfillment Balance
GET/v1/fulfillment/transactionsList Transactions
GET/v1/fulfillment/transactions/{id}Get Transaction
POST/v1/fulfillment/invoicesCreate overseas invoice
GET/v1/fulfillment/invoicesList overseas invoices
GET/v1/fulfillment/invoices/{id}Get Invoice
GET/v1/fulfillment/invoices/{id}/downloadDownload Invoice

Amounts use monetary_unit: CNY_minor. Create invoices from AVAILABLE transaction_ids only.

取引一覧フィルタ

All query params are optional. Enum filters are single-value only (no comma multi-select). Invalid enum → 422.

ParamMatchAllowed values / notes
typeExactCREDIT · DEBIT · REFUND · ADJUSTMENT
categoryExactTOP_UP · PROCUREMENT · SHIPPING · VALUE_ADDED_SERVICE · RETURN · STORAGE · TRANSFER · REFUND · MANUAL_ADJUSTMENT · OTHER
invoice_statusExactNOT_INVOICED · AVAILABLE · INVOICE_PENDING · INVOICED
related_resource_typeExactPACKAGE · SHIPMENT · RETURN · SERVICE_REQUEST · INBOUND
related_resource_idExactRelated object id
created_from / created_toRange on created_atISO-8601
page / page_sizePaginationDefault 1 / 20, max page_size 100
GET /v1/fulfillment/transactions?category=SHIPPING&invoice_status=AVAILABLE&page=1&page_size=20

請求書一覧フィルタ

All query params optional. status is single-value only. Invalid enum → 422.

ParamMatchAllowed values / notes
statusExactPENDING · ISSUED · REJECTED · CANCELLED
created_fromcreated_at >=ISO-8601 (request time)
created_tocreated_at <=ISO-8601
issued_fromissued_at >=ISO-8601; rows without issued_at are excluded
issued_toissued_at <=Same exclusion rule
page / page_sizePaginationDefault 1 / 20, max page_size 100

created_* and issued_* can be combined (AND). For downloadable invoices use status=ISSUED.

GET /v1/fulfillment/invoices?status=ISSUED&issued_from=2026-08-01T00:00:00Z&page=1&page_size=20

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support