POST Prepare Withdrawal endpoint.
Endpoint
POST
/web/v1/partner/withdrawals/prepare WEBAuthentication
- Chain: WEB
- JWT Token: true
- API Key: false
- Permissions: ["withdrawal: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 | Withdrawal channel business ID |
| amount | BigDecimal | Yes | Withdrawal amount (max 18.8 digits) |
| remark | String | No | Remark |
| bizParams | Map<String, Object> | No | Business params |
| idempotentKey | String | Yes | Idempotency key |
Response
200 OK
| Field | Type | Description |
|---|---|---|
| bizId | String | Withdrawal order business ID |
| workspaceBizId | String | Workspace business ID |
| channelBizId | String | Channel business ID |
| currencyCode | String | Currency code |
| amount | BigDecimal | Withdrawal amount |
| userFeeAmount | BigDecimal | User fee amount |
| channelFeeAmount | BigDecimal | Channel fee amount |
| walletDebitAmount | BigDecimal | Wallet debit amount |
| status | int | Order status |
| approvalStatus | int | Approval status |
| approvedBy | String | Approved by |
| approvedAt | Instant | Approval time |
| rejectionReason | String | Rejection reason |
| createdAt | Instant | Creation time |
| completedAt | Instant | Completion time |