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:
/papi/order/ip/renewal/createRequest Method:
POSTContent-Type:
application/jsonHeader Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Access-Key | string | Yes | API access key ID. See API Rules for authentication |
| X-Signature | string | Yes | Signature value, Base64-encoded HMAC-SHA256 result |
| X-Timestamp | string | Yes | Millisecond-level Unix timestamp (13 digits) |
| X-Nonce | string | Yes | Random string, 10~32 lowercase letters + digits |
Body Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| uid | string | Yes | UID of the proxy IP |
| packageCode | string | Yes | Renewal package code |
| payCode | string | Yes | Payment method code; use WALLET for pure wallet payment |
| providerCode | string | Yes | Payment provider code; use INTERNAL for pure wallet payment |
| autoRenew | integer | No | Auto-renewal setting (0-off, 1-on); omitting or passing null keeps the current setting |
| walletPayAmount | integer | No | Wallet payment amount for mixed payment (cents), must be greater than 0 and less than the total payable amount |
| payParams | object | No | Payment channel parameters |
Request Example:
{
"uid": "ip-uid-001",
"packageCode": "jeur2yj52s",
"payCode": "WALLET",
"providerCode": "INTERNAL",
"autoRenew": 1
}Response Parameters:
| Parameter | Type | Description |
|---|---|---|
| code | integer | Error code. See Error Codes |
| data | object | Response data |
| ├─ orderNo | string | Order number |
| ├─ payAmount | integer | Total payable amount of the order (cents) |
| ├─ walletPayAmount | integer | Wallet payment amount (cents) |
| ├─ onlinePayAmount | integer | Online payment amount (cents) |
| ├─ payUrl | string | Payment URL |
| ├─ paymentStatus | integer | Payment status |
| ├─ fulfillmentStatus | string | Fulfillment status |
| msg | string | Error message |
Response Example:
{
"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.
