4. 取消担保订单

如果交易中止，可以取消担保订单，剩余有效金额将原路返回给付款方。

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/partner/pay/alipay/wallet/cancel/trade

基础参数

参数名	类型	说明	示例
appid	String	合作伙伴AppId	uwkahf@jfs92
timestamp	String	当前时间戳
sign	String	接口签名	如何计算生成见示例代码
fc_biz_no	String	必填，传入原担保订单中的蜂巢订单号fc_biz_no
out_biz_no	json	必填，开发者侧订单号
order_title	String	必填， 订单标题，会在支付宝交易标题中显示

二、请求示例代码

Java

@Test
public void FCWalletCancelTrade() throws Exception {
    Map<String, String> data = new HashMap<String, String>();
    data.put("appid",  Config.AppId);
    Long timestamp = System.currentTimeMillis() / 1000;
    data.put("timestamp", timestamp.toString());
    data.put("fc_biz_no",  "20230615001924049701");
    data.put("out_biz_no",  "20230614-cancel-03");//自定义传入
    data.put("order_title",  "618达人活动取消");
    // 签名
    data.put("sign", Utils.Sign(data,Config.AppSecret));
    // 调用服务API
    String rsp =doHttpRequest(Config.FCWalletCancelTradeUrl ,data);
    System.out.println(rsp);
}

三、接口返回

网站调用下单支付接口，会得到一个付款链接， 在电脑上点击此链接， 跳到支付宝收银台。

{
  "code": 0,
  "message": "ok",
  "data": {
    "fc_distribute_sn": "20230613185006581863",
    "out_biz_no": "20230613-cancel-01",
    "trans_amount": 697,
    "trans_status": 1,
    "trans_fail_reason": "",
    "alipay_logon_id": "bitbeat2000@gmail.com",
    "alipay_real_name": "***原商家***",
    "order_id": "20230613020070011500460064398219"

  },
  "trace_id": ""
}

返回参数说明

参数名	类型	说明	示例
fc_distribute_sn	String	蜂巢侧转账流水号
out_biz_no	String	开发者侧订单号，原样返回
trans_amount	int	转账金额，即退还给付款金额，单位为分
trans_status	int	转账状态, 0: 未处理 1:成功 2:失败
trans_fail_reason	int	处理失败时的原因
alipay_logon_id	String	收款方支付宝
alipay_real_name	String	收款方支付宝姓名，由于是退回原付款方，此处脱敏
order_id	String	支付宝侧订单号