Skip to content

Static IP Renewal Order Creation ​

Create a renewal order for a static IP. Pure wallet payment uses payCode=WALLET and providerCode=INTERNAL; mixed payment uses an actual online payment method and additionally passes walletPayAmount. Static residential IPs and static datacenter IPs support renewal; dynamic IPs are not applicable.

Interface Address:

text
/papi/order/ip/renewal/create

Request Method:

text
POST

Content-Type:

text
application/json

Header Parameters:

ParameterTypeRequiredDescription
X-Access-KeystringYesAPI access key ID. See API Rules for authentication
X-SignaturestringYesSignature value, Base64-encoded HMAC-SHA256 result
X-TimestampstringYesMillisecond-level Unix timestamp (13 digits)
X-NoncestringYesRandom string, 10~32 lowercase letters + digits

Body Parameters:

ParameterTypeRequiredDescription
uidstringYesUID of the proxy IP
packageCodestringYesRenewal package code
payCodestringYesPayment method code; use WALLET for pure wallet payment
providerCodestringYesPayment provider code; use INTERNAL for pure wallet payment
autoRenewintegerNoAuto-renewal setting (0-off, 1-on); omitting or passing null keeps the current setting
walletPayAmountintegerNoWallet payment amount for mixed payment (cents), must be greater than 0 and less than the total payable amount
payParamsobjectNoPayment channel parameters

Request Example:

json
{
  "uid": "ip-uid-001",
  "packageCode": "jeur2yj52s",
  "payCode": "WALLET",
  "providerCode": "INTERNAL",
  "autoRenew": 1
}

Response Parameters:

ParameterTypeDescription
codeintegerError code. See Error Codes
dataobjectResponse data
├─ orderNostringOrder number
├─ payAmountintegerTotal payable amount of the order (cents)
├─ walletPayAmountintegerWallet payment amount (cents)
├─ onlinePayAmountintegerOnline payment amount (cents)
├─ payUrlstringPayment URL
├─ paymentStatusintegerPayment status
├─ fulfillmentStatusstringFulfillment status
msgstringError message

Response Example:

json
{
  "code": 0,
  "data": {
    "orderNo": "",
    "payAmount": 0,
    "walletPayAmount": 0,
    "onlinePayAmount": 0,
    "payUrl": "",
    "paymentStatus": 0,
    "fulfillmentStatus": ""
  },
  "msg": ""
}

Wallet payment rules ​

Wallet payment uses payCode=WALLET and providerCode=INTERNAL. Mixed payment uses the actual online channel plus an integer walletPayAmount in USD cents, greater than zero and below the calculated payable total; do not submit onlinePayAmount. Recharge orders cannot use wallet or mixed payment. On timeout or uncertain payment status, query the original order and transactions before retrying. Cancellation or switching to wallet payment requires reliable confirmation that an existing online payment is closed. Wallet deductions are returned against the original transaction when cancellation is permitted.

Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone Help Center