开发文档
快接官网 商户平台
  • 1、接口介绍

    商户系统先调用该接口在快接支付服务后台生成预支付交易订单,再按扫码、H5等不同场景发起支付

    支付方式 接口请求地址
    微信扫码支付 http://商户后台查看/wechat/scan_pay
    微信WAP(H5支付) http://商户后台查看/wechat/wap_pay
    微信WAP(H5支付)线上 http://商户后台查看/wechat/online_wap_pay
    微信APP支付 http://商户后台查看/wechat/app_pay
    微信公众号支付 http://商户后台查看/wechat/public_pay
    微信公众号支付线上 http://商户后台查看/wechat/online_public_pay
    微信扫码支付线上 http://商户后台查看/wechat/online_scan_pay
    微信小程序支付 http://商户后台查看/wechat/mini_pay
    微信小程序支付线上 http://商户后台查看/wechat/online_mini_pay
    微信被扫支付 http://商户后台查看/wechat/micropay
  • 2、请求参数

    序号 请求参数 是否必填 类型 最大长度 描述 示范值
    1 agent_no String 20 代理商号(商户类型为代理时,必传,快接平台分配给接入代理商唯一的编号,请登录代理后台代理中心查看 201857831440477
    2 merchant_no String 20 快接平台分配的唯一商户号 2017092012
    3 merchant_order_no String 35 商户订单号 201709191749201232asdas
    4 notify_url String 100 通知地址 http://www.kj-pay.com/
    5 start_time String 14 订单开始时间(格式为yyyyMMddHHmmss) 20171028100150
    6 trade_amount String 11 交易金额 单位为元,精确到小数点后两位,取值 0.01
    7 goods_name String 50 商品名称 测试商品
    8 goods_desc String 100 商品描述 test
    9 return_url String 100 同步跳转地址(需要同步跳转时,请确保该值为正确地址,并且pay_mode值必须为2) http://www.kj-pay.com/
    10 app_no String 35 应用编号(可在商户中心->应用管理->应用信息 处选择该订单所属应用编号) 201710231452342219
    11 attach String 255 业务扩展参数,该参数异步通知时原样返回,不填则不返回 1
    12 user_ip String 15 IP地址,H5必填参数 Ip获取方式参考地址 https://pay.weixin.qq.com/wiki/doc/api/H5.php?chapter=15_5
    13 pay_sence String 255 支付场景,H5必填参数 苹果传示例值1,安卓传示例值2,Wap端传示例值3,注意参数值部分替换成自己的 1、{"type":"IOS","bundle_id":"com.tencent.wzryIOS","app_name":"王者荣耀"} 2、{"type":"Android","app_name": "王者荣耀","package_name": "com.tencent.tmgp.sgame"} 3、{"type":"Wap","wap_url": "http://www.kj-pay.com","wap_name": "快接支付"}
    14 pay_type String 1 返回支付参数类型(默认值为0,类型0:base64二维码图,1:二维码图片渲染页,2:纯二维码图片,3:支付链接 ) 1
    15 receivers String 2048 分账接收方列表(JSON类型的字符串),需走分账业务并需要传分账接收方的必填;注:下方带└符号参数表示为该参数中的数据;订单无需分账时receivers不传即可 分账接收方列表 不超过49个 json对象 示例值、 [{"type":"PERSONAL_OPENID","account":"oSepO0vHk3uvhdRrdjEbygdUTprA","name":"张三", "amount":"0.01", "description":"分到个人"}]
    16 └ type String 32 分账接收方类型 1、MERCHANT_ID-商户ID 2、PERSONAL_OPENID-(商户后台->交易分账管理->微信openID可得到) 3、PERSONAL_SUB_OPENID-个人sub_openid(由子商户APPID转换得到) PERSONAL_OPENID
    17 └ account String 64 分账接收方帐号 1、类型是MERCHANT_ID时,是商户ID (联系客服获取) 2、类型是PERSONAL_OPENID时,是openid(商户后台可得) 3、类型是PERSONAL_SUB_OPENID时,是个人sub_openid(由子商户APPID转换得到) oSepO0vHk3uvhdRrdjEbygdUTprA
    18 └ name String 1024 分账接收方全称 1、分账接收方类型是MERCHANT_ID时,是商户全称(联系客服获取) 2、分账接收方类型是PERSONAL_OPENID或PERSONAL_SUB_OPENID 时,是个人姓名 张三
    19 └ amount String 11 交易金额 单位为元,不能超过原订单支付金额及最大分账比例金额。精确到小数点后两位,取值范围[0.01,100000000] 0.01
    20 └ description String 80 分账描述 分给商户A
    21 open_id String 28 微信公众号可传该字段,则openid由用户自行产生,快接平台将不进行微信网页授权回调 ocbthxP77MfGj0p11r-4RUbb1nKM
    22 auth_code String 80 付款码数字,微信被扫支付必须 131563858867504301
    23 terminal_id String 50 终端设备号,微信被扫支付必须 D00000XXX
    24 sign_type String 1 签名类型(1->md5) 1
    25 sign String 32 签名 88772a091467bc0fa4790bcad0b1ee69
    微信官方通道receivers参数
    序号 请求参数 是否必填 类型 最大长度 描述 示范值
    1 └ type String 32 分账接收方类型 1、MERCHANT_ID-商户ID 2、PERSONAL_OPENID-(商户后台->交易分账管理->微信openID可得到) 3、PERSONAL_SUB_OPENID-个人sub_openid(由子商户APPID转换得到) PERSONAL_OPENID
    2 └account String 11 分账接收方帐号 1、类型是MERCHANT_ID时,是商户ID (联系客服获取) 2、类型是PERSONAL_OPENID时,是openid(商户后台可得) 3、类型是PERSONAL_SUB_OPENID时,是个人sub_openid(由子商户APPID转换得到) oSepO0vHk3uvhdRrdjEbygdUTprA
    3 └ name String 1024 分账接收方全称 1、分账接收方类型是MERCHANT_ID时,是商户全称(联系客服获取) 2、分账接收方类型是PERSONAL_OPENID或PERSONAL_SUB_OPENID 时,是个人姓名 张三
    4 └ amount String 11 交易金额 单位为元,不能超过原订单支付金额及最大分账比例金额。精确到小数点后两位,取值范围[0.01,100000000] 0.01
    5 └ description String 80 分账描述 分账给商户A
    非微信官方通道receivers参数——单次实时分账
    序号 请求参数 是否必填 类型 最大长度 描述 示范值
    1 member_id String 11 分账接收方用户标识,通过快接商务入驻获取 20040801
    2 amount String 10 分账金额,精确到小数点后两位;分账总额不得大于订单结算金额,未分账金额将结算至交易商户结算账户 0.01
  • 3、响应参数

    序号 返回参数 是否必填 字段类型 描述
    1 data String json数据
    2 └ trade_no String 交易订单号
    3 └ pay_url String 支付链接
    4 └ image String 二维码图片数据串,扫码支付返回的是image,其他默认都是pay_url
    5 └ sign String 签名
    6 info String 描述
    7 status String 返回码 示例:1 接口请求成功; 99 接口请求失败; 30 响应验签失败