手续费试算
本接口用于在发起代付前,试算充值手续费、代付手续费及相关订单金额。接口仅进行试算,不发起交易。
|
报文编号 |
版本号 |
| 请求 |
[TBD] |
1.0.0 |
| 应答 |
[TBD] |
1.0.0 |
对接要求:需要签名验签
请求方法
POST
请求报文(JSON 格式)
| 参数名 |
类型 |
是否必填 |
是否加密 |
长度限制 |
描述 |
示例值 |
| uid |
String(64) |
M |
否 |
64 |
交易统一会员号 |
|
| orderId |
String(64) |
M |
否 |
64 |
请求流水号,仅允许字母、数字和下划线 |
REQ202608120001 |
| orderAmount |
Long |
M |
否 |
- |
试算金额,单位为分,不能小于 1 |
10000 |
| requestTime |
String |
O |
否 |
19 |
请求时间,格式 yyyy-MM-dd HH:mm:ss;未传默认当前系统时间 |
2026-08-12 10:00:00 |
响应参数
公共报文 - 返回参数
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| code |
返回码 |
String(64) |
C |
响应码,000000 代表请求成功 |
| message |
返回信息 |
String(32) |
C |
响应信息 |
| success |
响应状态 |
Boolean |
M |
true:响应成功;false:业务异常 |
| data |
返回参数 |
JSON |
C |
见下方返回参数 |
返回参数(data)
| 字段名 |
类型 |
是否必填 |
描述 |
| basicBalance |
Long |
M |
基本户余额,单位为分 |
| rechargeAmount |
Long |
M |
充值差额,单位为分 |
| rechargeFee |
Long |
M |
充值手续费,单位为分 |
| rechargeFeeType |
String(8) |
M |
充值手续费扣费类型:IN 内扣、OUT 外扣 |
| rechargeFeeMemberId |
String(32) |
C |
充值手续费承担方商户号 |
| rechargeFeeOwnBasic |
Boolean |
M |
充值手续费是否由当前商户自身基本户承担 |
| rechargeOrderAmount |
Long |
M |
充值订单金额,单位为分 |
| actualRechargeAmount |
Long |
M |
实际充值到账金额,单位为分 |
| payFee |
Long |
M |
代付手续费,单位为分 |
| payFeeType |
String(8) |
M |
代付手续费扣费类型:IN 内扣、OUT 外扣 |
| payFeeMemberId |
String(32) |
C |
代付手续费承担方商户号 |
| payFeeOwnBasic |
Boolean |
M |
代付手续费是否由当前商户自身基本户承担 |
| payOrderAmount |
Long |
M |
代付订单金额,单位为分 |
| actualPayAmount |
Long |
M |
实际代付到账金额,单位为分 |
| expectedBasicBalance |
Long |
M |
交易完成后的预计基本户余额,单位为分 |
| finishTime |
String |
M |
试算完成时间,格式 yyyy-MM-dd HH:mm:ss |