卡提现

POST /openapi/v1/funds/cardWithdrawals

项	内容
请求方法	POST
请求路径	/openapi/v1/funds/cardWithdrawals
请求类型	application/json

请求参数：

字段	类型	必填	说明
requestNo	string	是	调用方业务幂等号，最大 64 位。
cardId	string	是	卡 ID，最大 128 位。
amount	number	是	提现总额，已包含平台手续费；大于 0，最多 18 位整数和 18 位小数。
currency	string	是	币种，最大 32 位。

响应 data：

字段	类型	说明
orderNo	string	平台提现订单号。
requestNo	string	调用方业务幂等号。
cardId	string	卡 ID。
amount	number	请求提现总额，已包含平台手续费。
currency	string	提现币种。
feeAmount	number	手续费总额；新订单等于平台手续费。
platformFeeAmount	number	平台手续费金额。
tenantFeeAmount	number	兼容字段；新订单固定为 0，历史订单保留原快照。
totalAmount	number	请求提现总额，与 amount 一致。
accepted	boolean	Provider 是否已明确受理；提交结果未知时为 false。
status	string	订单状态，取值 PROCESSING、SUCCESS、FAILED。
failCode	string	失败码；Provider 提交结果未知时为 SUBMIT_UNKNOWN。
failMessage	string	失败说明。
createTime	string	订单创建时间。
completedTime	string	订单终态时间。

金额关系：

平台手续费 = 按 amount 计算
本金 = amount - platformFeeAmount
CPlus 划转金额 = amount
租户入账 = 本金
平台入账 = platformFeeAmount

当 Provider 调用异常、返回空响应或缺少 transferId 时，接口返回 status=PROCESSING、accepted=false、failCode=SUBMIT_UNKNOWN。该状态不表示失败， 提现总额仍保持冻结，等待后续明确的成功或失败 webhook 结算。