跳转到内容

卡提现 ​

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

请求参数:

字段类型必填说明
requestNostring是调用方业务幂等号,最大 64 位。
cardIdstring是卡 ID,最大 128 位。
amountnumber是提现总额,已包含平台手续费;大于 0,最多 18 位整数和 18 位小数。
currencystring是提现币种,支持 USD、USDT,最大 32 位。

响应 data:

字段类型说明
orderNostring平台提现订单号。
requestNostring调用方业务幂等号。
cardIdstring卡 ID。
amountstring请求提现总额,已包含平台手续费。
currencystring提现币种。
feeAmountstring手续费总额;新订单等于平台手续费。
platformFeeAmountstring平台手续费金额。
tenantFeeAmountstring兼容字段;新订单固定为 0,历史订单保留原快照。
totalAmountstring请求提现总额,与 amount 一致。
acceptedbooleanProvider 是否已明确受理;提交结果未知时为 false。
statusstring订单状态,取值 PROCESSING、SUCCESS、FAILED。
failCodestring失败码;Provider 提交结果未知时为 SUBMIT_UNKNOWN。
failMessagestring失败说明。
createTimestring订单创建时间。
completedTimestring订单终态时间。

响应金额为非科学计数法十进制字符串,不保证保留末尾零;请求中的 amount 仍使用 JSON 数字。

金额关系:

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

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