POST Create Recharge endpoint.

Endpoint

POST/web/v1/partner/recharges WEB

Authentication

• Chain: WEB
• JWT Token: true
• API Key: false
• Permissions: ["recharge:create"]
• Secure Channel: REQUIRED

Rate Limit

120 requests per 60 seconds.

Headers

Frontend Headers

Header	Required	Description
X-LOCALE	Yes	用户的 locale
Accept-Language	No	语言偏好

Cloudflare Headers

Header	Required	Description
CF-Connecting-IP	Yes	Client IP from Cloudflare
CF-IPCountry	Yes	Client country code
CF-Ray	Yes	Cloudflare Ray ID
CF-Visitor	Yes	Visitor scheme
X-Real-IP	Yes	Real client IP

Nginx Headers

Header	Required	Description
X-PORTAL-ACCESS-CODE	Yes	Portal access code
X-Real-IP	Yes	客户端真实 IP
X-Forwarded-For	Yes	代理链
X-Forwarded-Proto	Yes	协议

Request Parameters

Body (JSON)

Field	Type	Required	Description
channelBizId	String	Yes	Channel business ID (max 64)
amount	BigDecimal	Yes	Recharge amount (max 18.8 digits)
idempotentKey	String	Yes	Idempotency key (max 128)
remark	String	No	Remark (max 256)
bizParams	Map<String, Object>	No	Business params

Response

201 Created

Field	Type	Description
bizId	String	Recharge order business ID
workspaceBizId	String	Workspace business ID
channelBizId	String	Channel business ID
currency	String	Currency code
amount	BigDecimal	Recharge amount
userFeeAmount	BigDecimal	User fee amount
channelFeeAmount	BigDecimal	Channel fee amount
netAmount	BigDecimal	Net amount
status	Integer	Order status
expiredAt	Instant	Expiry time
proofFileBizId	String	Proof file business ID
proofUploadedAt	Instant	Proof upload time
operatorRemark	String	Operator remark
cancelReason	String	Cancel reason
channelConfigSnapshot	String	Channel config snapshot
createdAt	Instant	Creation time
completedAt	Instant	Completion time

Phase 3 Simulation