开发文档
快接官网商户平台
  • 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、请求参数

    序号请求参数是否必填类型最大长度描述示范值
    1agent_noString20代理商号(商户类型为代理时,必传,快接平台分配给接入代理商唯一的编号,请登录代理后台代理中心查看201857831440477
    2merchant_noString20快接平台分配的唯一商户号2017092012
    3merchant_order_noString35商户订单号201709191749201232asdas
    4notify_urlString100通知地址http://www.kj-pay.com/
    5start_timeString14订单开始时间(格式为yyyyMMddHHmmss)20171028100150
    6trade_amountString11交易金额 单位为元,精确到小数点后两位,取值0.01
    7goods_nameString50商品名称测试商品
    8goods_descString100商品描述test
    9return_urlString100同步跳转地址(需要同步跳转时,请确保该值为正确地址,并且pay_mode值必须为2)http://www.kj-pay.com/
    10app_noString35应用编号(可在商户中心->应用管理->应用信息 处选择该订单所属应用编号)201710231452342219
    11attachString255业务扩展参数,该参数异步通知时原样返回,不填则不返回1
    12user_ipString15IP地址,H5必填参数Ip获取方式参考地址 https://pay.weixin.qq.com/wiki/doc/api/H5.php?chapter=15_5
    13pay_senceString255支付场景,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": "快接支付"}
    14pay_typeString1返回支付参数类型(默认值为0,类型0:base64二维码图,1:二维码图片渲染页,2:纯二维码图片,3:支付链接 )1
    15receiversString2048分账接收方列表(JSON类型的字符串),需走分账业务并需要传分账接收方的必填;注:下方带└符号参数表示为该参数中的数据;订单无需分账时receivers不传即可分账接收方列表 不超过49个 json对象 示例值、 [{"type":"PERSONAL_OPENID","account":"oSepO0vHk3uvhdRrdjEbygdUTprA","name":"张三", "amount":"0.01", "description":"分到个人"}]
    16└ typeString32分账接收方类型 1、MERCHANT_ID-商户ID 2、PERSONAL_OPENID-(商户后台->交易分账管理->微信openID可得到) 3、PERSONAL_SUB_OPENID-个人sub_openid(由子商户APPID转换得到)PERSONAL_OPENID
    17└ accountString64分账接收方帐号 1、类型是MERCHANT_ID时,是商户ID (联系客服获取) 2、类型是PERSONAL_OPENID时,是openid(商户后台可得) 3、类型是PERSONAL_SUB_OPENID时,是个人sub_openid(由子商户APPID转换得到)oSepO0vHk3uvhdRrdjEbygdUTprA
    18└ nameString1024分账接收方全称 1、分账接收方类型是MERCHANT_ID时,是商户全称(联系客服获取) 2、分账接收方类型是PERSONAL_OPENID或PERSONAL_SUB_OPENID 时,是个人姓名张三
    19└ amountString11交易金额 单位为元,不能超过原订单支付金额及最大分账比例金额。精确到小数点后两位,取值范围[0.01,100000000]0.01
    20└ descriptionString80分账描述分给商户A
    21open_idString28微信公众号可传该字段,则openid由用户自行产生,快接平台将不进行微信网页授权回调ocbthxP77MfGj0p11r-4RUbb1nKM
    22auth_codeString80付款码数字,微信被扫支付必须131563858867504301
    23terminal_idString50终端设备号,微信被扫支付必须D00000XXX
    24sign_typeString1签名类型(1->md5)1
    25signString32签名88772a091467bc0fa4790bcad0b1ee69
    微信官方通道receivers参数
    序号请求参数是否必填类型最大长度描述示范值
    1└ typeString32分账接收方类型 1、MERCHANT_ID-商户ID 2、PERSONAL_OPENID-(商户后台->交易分账管理->微信openID可得到) 3、PERSONAL_SUB_OPENID-个人sub_openid(由子商户APPID转换得到)PERSONAL_OPENID
    2└accountString11分账接收方帐号 1、类型是MERCHANT_ID时,是商户ID (联系客服获取) 2、类型是PERSONAL_OPENID时,是openid(商户后台可得) 3、类型是PERSONAL_SUB_OPENID时,是个人sub_openid(由子商户APPID转换得到)oSepO0vHk3uvhdRrdjEbygdUTprA
    3└ nameString1024分账接收方全称 1、分账接收方类型是MERCHANT_ID时,是商户全称(联系客服获取) 2、分账接收方类型是PERSONAL_OPENID或PERSONAL_SUB_OPENID 时,是个人姓名张三
    4└ amountString11交易金额 单位为元,不能超过原订单支付金额及最大分账比例金额。精确到小数点后两位,取值范围[0.01,100000000]0.01
    5└ descriptionString80分账描述分账给商户A
    非微信官方通道receivers参数——单次实时分账
    序号请求参数是否必填类型最大长度描述示范值
    1member_idString11分账接收方用户标识,通过快接商务入驻获取20040801
    2amountString10分账金额,精确到小数点后两位;分账总额不得大于订单结算金额,未分账金额将结算至交易商户结算账户0.01
  • 3、响应参数

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