Create a Static Proxy Renewal Order

POST /open-api/v1/static/renewal-orders

Base URL: https://api.ipfbs.com/gin.

Authentication

Send your key in the X-API-Key request header.

JSON request body

Field	Type	Required	Constraints	Meaning
request_no	string	Yes	minLength: 1; maxLength: 64; pattern: ^[A-Za-z0-9_-]{1,64}$	Caller request number for duplicate protection.
resource_ids	string[]	Yes	minItems: 1; maxItems: 500	Resource IDs selected for renewal.
duration_days	integer	Yes	format: int32; minimum: 1	Duration in days. Use a positive integer supported by the active price catalog.
callback_url	string	No	maxLength: 2048	Optional terminal status callback URL, subject to server validation.

Request example

curl --request POST \
  --url 'https://api.ipfbs.com/gin/open-api/v1/static/renewal-orders' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "request_no": "static_renew_20260824_001",
  "resource_ids": [
    "1912345678901234567"
  ],
  "duration_days": 30
}'

Success response data

Responses use code, msg, data, and next. HTTP 200 can also contain a nonzero business error code; check code first.

Field	Type	Required	Constraints	Meaning
data.order_no	string	No	—	Order no.
data.status	string	No	enum: PROCESSING	Current status of this resource or order.
data.duration_days	integer	No	format: int32; minimum: 1	Duration in days. Use a positive integer supported by the active price catalog.
data.total_quantity	integer	No	format: int32; minimum: 1; maximum: 500	Total quantity.
data.order_amount	string	No	—	Order or quote amount as a decimal string.
data.currency	string	No	—	Currency.
data.create_time	string	No	format: date-time	Create time.

Endpoint notes

The wallet is charged when the renewal order is accepted; fulfillment is asynchronous. All resources use the same positive integer duration. Each resource group must have an active price.

Related conventions

Request conventions · Response structure · Error codes · API reference index