POST Prepare Transfer endpoint.

Endpoint

POST/web/v1/partner/transfers/command/prepare WEB

Authentication

• Chain: WEB
• JWT Token: true
• API Key: false
• Permissions: ["transfer: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
idempotentKey	String	Yes	Idempotency key (max 128)
fromWalletId	String	Yes	Source wallet ID (max 64)
toWalletId	String	Yes	Target wallet ID (max 64)
currency	String	Yes	Currency code (3-5 chars)
amount	BigDecimal	Yes	Transfer amount (max 18.8 digits)
remark	String	No	Remark (max 256)

Response

200 OK

Field	Type	Description
bizId	String	Transfer order business ID
fromWalletId	String	Source wallet ID
toWalletId	String	Target wallet ID
currency	String	Currency code
amount	BigDecimal	Transfer amount
feeAmount	BigDecimal	Fee amount
totalAmount	BigDecimal	Total amount (amount + fee)
status	Integer	Status code
statusName	String	Status display name
failureReason	String	Failure reason (if failed)
remark	String	Remark
createdAt	Instant	Creation time
completedAt	Instant	Completion time

Phase 3 Simulation