斗拱创客平台

（1）聚合正扫

应用场景：

场景1-台牌码：用户通过扫描聚合静态二维码，输入订单金额完成支付操作。

场景2-公众号/小程序商城：用户通过公众号/小程序下单，输入密码完成支付操作。

场景3-商户根据用户选择支付方式，调用该接口生成支付宝/银联/数字人民币，用户使用对应app下扫一扫完成支付操作。

适用对象：开通微信/支付宝/银联二维码/数字人民币权限的商户

1、公共请求参数：

加签验签说明： https://paas.huifu.com/open/doc/guide/#/api_v2jqyq

2、请求参数：

3、请求示例代码如下：

{
    "sys_id": "6666000108840829",
    "product_id": "YYZY",
    "data": {
        "pay_scene": "02",
        "time_expire": "20250518235959",
        "limit_pay_type": "NO_CREDIT",
        "terminal_device_data": "{\"device_ip\":\"10.10.0.1\",\"device_icc_id\":\"\",\"devs_id\":\"SPINTP357338300264411\",\"device_mac\":\"\",\"device_imei\":\"\",\"device_gps\":\"192.168.0.0\",\"device_imsi\":\"\",\"device_type\":\"1\",\"device_wifi_mac\":\"\"}",
        "alipay_data": "{\"store_id\":\"\",\"extend_params\":{\"hb_fq_seller_percent\":\"\",\"sys_service_provider_id\":\"1111111\",\"food_order_type\":\"qr_order\",\"hb_fq_num\":\"\",\"industry_reflux_info\":\"string\",\"parking_id\":\"123wsx\",\"card_type\":\"\"},\"operator_id\":\"123213213\",\"alipay_store_id\":\"\",\"buyer_logon_id\":\"string\",\"buyer_id\":\"208870269990XXXX\",\"product_code\":\"string\",\"goods_detail\":[{\"goods_name\":\"汇付\",\"quantity\":\"20\",\"price\":\"43.00\",\"goods_id\":\"12312321\",\"goods_category\":\"\",\"body\":\"\",\"categories_tree\":\"string\",\"show_url\":\"\"}],\"merchant_order_no\":\"string\",\"seller_id\":\"string\"}",
        "trans_amt": "0.10",
        "risk_check_data": "{\"base_station\":\"192.168.1.1\",\"latitude\":\"33.3\",\"ip_addr\":\"180.167.105.130\",\"longitude\":\"33.3\"}",
        "remark": "string",
        "goods_desc": "hibs自动化-通用版验证",
        "notify_url": "http://www.baidu.com",
        "delay_acct_flag": "N",
        "fq_mer_discount_flag": "N",
        "req_seq_id": "20240621101119466q67qrxlv95wyrt",
        "req_date": "20240621",
        "channel_no": "",
        "term_div_coupon_type": "0",
        "unionpay_data": "{}",
        "trade_type": "A_NATIVE",
        "huifu_id": "6666000109133323",
        "wx_data": "{\"openid\":\"\",\"detail\":{\"receipt_id\":\"20220628132043853798\",\"goods_detail\":[{\"goods_name\":\"太龙双黄连口服液\",\"wxpay_goods_id\":\"12235413214070356458058\",\"quantity\":\"1\",\"price\":\"43.00\",\"goods_id\":\"6934572310301\"}],\"cost_price\":\"43.00\"},\"sub_appid\":\"wxdfe9a5d141f96685\",\"sub_openid\":\"o8jhotzittQSetZ-N0Yj4Hz91Rqc\",\"scene_info\":{}}",
        "acct_split_bunch": "{\"acct_infos\":[{\"huifu_id\":\"6666000109133323\",\"div_amt\":\"0.10\"}]}"
    },
    "sign": "Y/D3Gjqk97C2pSlvZpoY9fULL2yAYu5vj0AIRuJDcPKa2t7mM3FfXpjJD+SxMo2WvhQx5MptXa5barW80MK2BgiDiqFCllg19o77PMDVHWVuaklLxhNuev2IHjangLTIg7GCIKZNlpYCnbU9gYxkfpLnz3IM0jvdHuHqMaB44bec9rO8x8cauXEp0HTsuXBL/fH6n9N5tmHapXzJnt3Qey17PjQrNTTj6nnR1vSGBx4hJQjWfERAu7AtwdvVBVvhp9CdV3kVU7qnfdXTjWGUIqAc7pYvZ0neyyOQ/Zdf9rFWSwNWUHTfaIzbNA3lL1/VLF3yF6YTe2prioKaKiIruQ=="}

4、同步返回核心字段：

同步返回仅代表下单成功，最终支付结果需以异步返回的trans_stat为准。

5、异步通知地址：由notify_url参数指定

6、webhook说明：

斗拱交易完成后除了返回异步消息也支持另外发送webhook事件。webhook事件可以灵活配置多个接收端用于驱动业务流程。比如交易完成后发送webhook消息给财务系统入账，发送到物流系统配送商品等等。

webhook的使用参见说明： https://paas.huifu.com/docs/devtools/#/webhook/webhook_jieshao

聚合正扫接入详情链接见：https://paas.huifu.com/open/doc/api/#/smzf/api_jhzs?id=%e8%81%9a%e5%90%88%e6%ad%a3%e6%89%ab

（2）聚合反扫

应用场景

商家通过扫码设备，扫描用户出示的付款码完成收款（支持微信/支付宝/银联二维码/数字人民币)。支持微信反扫、支付宝反扫、银联二维码反扫、数字人民币反扫交易。

注意：微信、支付宝交易有订单超时时间，默认两小时关单。

适用对象：开通微信/支付宝/银联二维码/数字人民币权限的商户

1、公共请求参数

2、必填项参数

3、示例代码如下

{
    "sys_id": "6666000108840829",
    "data": {
        "req_seq_id": "20240423135730123ze1ds5x8sf2tsi",
        "req_date": "20240423",
        "trans_amt": "1.01",
        "risk_check_data": "{\"ip_addr\":\"180.167.105.130\",\"base_station\":\"192.168.1.1\",\"latitude\":\"33.3\",\"longitude\":\"33.3\"}",
        "huifu_id": "6666000109133323",
        "goods_desc": "聚合反扫消费",
        "notify_url": "http://www.baidu.com",
        "auth_code": "131135212661863252"
    },
    "product_id": "YYZY",
    "sign": "MwEL0FuZoGF6n6yTLsO/W1NXAT7gJAKitWy6TrXw8GyDOYCatvsW+JVReoL8RMX3a1FmuZ7b90OJcmjh6gNy8kXTi+oB5TSQWE1ZHrSdCo8Jq5g1PP3ewXNxsZWWmQot6mWBls8eMFci+e57Y3PC6YdnAPxwP0xzaH6/QV0YrUkshGdcHOqAmxPq9I9wIJMIe3u7hne4Vgqytn+XRx1kuLRc04H86hmq4w2ynRTGY5p8ygzWYr/+bGHJ06wNO99J+V35j+LDS0fuDCU7HSJ4zcKWQALm3+tDDi4c/NGn103HN07CWLV1Lqq7C7dd+zECV0gNYRMRHTgV0+yC94l+4Q=="
}

4、同步返回字段