发起免密支付
发起免密支付,会自动判断是否开通了支付宝或者诚E赊的免密支付,并发起扣款。优先发起诚E赊自动扣款,如果失败,则尝试支付宝自动扣款。该接口目前返回错误码不详,在发起扣款失败后,建议重试3次,不要无限制重试。
1.请求参数:
请求URL:
POST https://open.fw199.com/gateway/1688/fenxiao/trade/pay/protocolpay/preparepay
基础参数
参数名 | 类型 | 必须 | 示例值 | 说明 |
---|---|---|---|---|
appid | String | true | 32432143214214 | 合作伙伴AppId |
timestamp | String | true | 1633618722 | 当前时间戳 |
seller_nick | String | true | b2b-1624961122 | 1688账号 |
sign | String | true | 999de41d862efaa6f1084ead3b3ba480 | 如何计算生成见示例代码 |
业务参数
名称 | 类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
orderIdorderId | java.lang.Longjava.lang.Long | 是是 | 订单ID订单ID | 19384898231938489823 |
payChannelpayChannel | StringString | 否否 | 跨境宝支付传入kjpayV2跨境宝支付传入kjpayV2 | kjpayV2kjpayV2 |
payAmountpayAmount | LongLong | 否否 | 付款总金额,单位分付款总金额,单位分 | 123123 |
opRequestIdopRequestId | StringString | 否否 | requestidrequestid | 134134134134134134 |
2. 请求示例代码(Java)
@Test
public void One688FenXiaoTradeProtocolPayPreparePay() throws Exception {
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("seller_nick", Config.AlibabaFenXiaoSellerNick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("opRequestId","20250328-001");
data.put("orderId","4281535369018969811");
data.put("payAmount","9800");
data.put("payChannel","ALIPAY");
data.put("sign", Utils.Sign(data, Config.AppSecret));
// 调用服务API
String response = doHttpRequest(Config.One688FenXiaoTradeProtocolPayPreparePayUrl, data);
}
3. 返回结果如下:
3.1 成功的情况
{
"code": 0,
"message": "ok",
"data": {
"code": "0",
"message": "",
"success": true,
"result": {
"payChannel": "ALIPAY",
"paySuccess": true
}
},
"trace_id": ""
}
3.2 失败的情况
{
"code": 0,
"message": "ok",
"data": {
"code": "500",
"message": "不是自己的订单",
"success": false
},
"trace_id": ""
}
说明: code为0表示成功,非0为失败,message会包含失败原因。 详细返回字段说明
名称 | 类型 | 描述 | 示例值 |
---|---|---|---|
payChannel | String | 支付成功渠道 | Alipay |
paySuccess | Boolean | 支付是否成功,在超时的情况下,可能返回false但实际扣款成功的情况,需要查询订单实际支付状态 | true |
文档更新时间: 2025-05-26 17:30 作者:admin