搜索
扫码支付API接口说明扫码支付API接口开发指南商户接口规范版本(3.0.7)修订时间：2017-08-01扫码支付API接口说明目录第一章文档描述......................................................................................................................31、文档说明........................................................................................................................32、阅读对象........................................................................................................................33、名词定义........................................................................................................................3第二章接口定义......................................................................................................................31、扫码支付........................................................................................................................32、公众号支付....................................................................................................................33、支付异步通知..............................................................................................................104、交易查询......................................................................................................................125、对账查询......................................................................................................................14第三章签名说明......................................................................................................................161、签名算法......................................................................................................................162、密钥生产......................................................................................................................16附录1错误码说明..................................................................................................................17扫码支付API接口说明第一章文档描述1、文档说明本说明文档用于指导商户接入扫码支付API系统进行的对接，目前支持支付宝、微信扫码。请相关技术人员详细阅读本文档。2、阅读对象商户开发人员。扫码支付API接口相关技术人员。3、名词定义合作方：指对接扫码支付平台的机构。商户：指委托收单的营业机构，如超市、便利店等。用户：指在商户系统内进行消费的企业或者个人。商户ID：指支付系统为使用外部接入接口的商户统一分配的唯一标识。商户密钥：指商户在和支付系统进行数据签名认证的密钥，采用RSA加密算法。第二章接口定义1、扫码支付1、接入URL：扫码支付API接口说明2、接入方式：POST方式均可3、请求协议参数：参数名参数数据类型必填说明订单IDorderIdVARCHARY交易订单ID支付通道payTypeVARCHARY支付通道：WXZF-微信支付，ZFBZF-支付宝支付商户编码merchantCodeVARCHARY商户编码，接入时系统分配交易金额totalAmountVARCHARY交易金额，单位：元，最小2元交易标题subjectVARCHARY交易标题，显示在微信或支付宝支付页面交易描述descVARCHARY交易描述商户操作员idoperatorIdVARCHARN操作员编号，如员工编码门店编号storeIdVARCHARN商户的门店编号商户终端编号terminalIdVARCHARY商户机器的终端编号支付方式limitPayVARCHARN微信/支付宝：1-不能使用信用卡支付宝：2-不适用花呗3-不使用信用卡/花呗来源信息sourceVARCHARN支付宝分配给下游的pid识别号，2088开头的一串16位数字,对应支付宝的sys_service_provider_id字段商品标记goodsTagVARCHARN微信渠道可选上送，代金券或立减优惠功能参数，对应微信的goods_tag字段扫码支付API接口说明支付宝目前用不到该参数。支付有效时间expireTimeVARCHARN指定订单的支付有效时间（分钟数），超过有效时间用户将无法支付。若不指定该参数则系统默认设置24小时支付有效时间。参数允许设置范围：1-1440区间的整数值，超过1440默认设置1440支付宝：用户扫码后开始计算支付有效时间微信：用户下单后开始计算支付有效时间回调通知地址notifyurlVARCHARY支付成功失败的通知地址交易终端ipcreateipVARCHARY交易终端IP备注extend1VARCHARN备注信息，测试系统必填签名signVARCHARYRSA签名4、返回协议参数：参数名参数数据类型必填说明返回状态rspCodeVARCHARY返回的错误码，000000代表成功，其它为失败返回信息rspMsgVARCHARY返回信息二维码链接qrCodeVARCHARY订单的二维码，商户生成二维码提供给用户扫码支付签名signVARCHARYRSA签名5、接入实例：请求提交方法：{payType:ZFBZF,orderId:WE1124567810,扫码支付API接口说明merchantCode:91303221707200006,totalAmount:2,subject:firsttest,desc:testproduct,body:testproduct,terminalId:1213412134,extend1:test,notifyurl::192.168.0.1}返回值：{rspCode:000000,rspMsg:OK,qrCode::Ek7H4c6f5OgechohLFrxcgPoGC/vVy0Bg5XDzYGVIReHYaFtEBfSUxhSxCf/rDMhM+DZKJaw5jhTU1mE1ijEQoguj6c6gKDSg6fXuEEwbKODlQDW9cHRFxMVki2THexox/g8KgipUiEW5HOdNNm4LcwQe8YC+8gauHcKEXSW7Rw=}2、公众号支付1、接入URL：、接入方式：POST方式均可3、请求协议参数：参数名参数数据类型必填说明订单IDorderIdVARCHARY交易订单ID支付通道payTypeVARCHARY支付通道：WXZF-微信支付商户编码merchantCodeVARCHARY商户编码，接入时系统分配扫码支付API接口说明交易金额totalAmountVARCHARY交易金额，单位：元，最小2元交易标题subjectVARCHARY交易标题，显示在微信或支付宝支付页面交易描述descVARCHARY交易描述商户操作员idoperatorIdVARCHARN操作员编号，如员工编码门店编号storeIdVARCHARN商户的门店编号商户终端编号terminalIdVARCHARY商户机器的终端编号支付方式limitPayVARCHARN微信/支付宝：1-不能使用信用卡支付宝：2-不适用花呗3-不使用信用卡/花呗商品标记goodsTagVARCHARN微信渠道可选上送，代金券或立减优惠功能参数，对应微信的goods_tag字段支付宝目前用不到该参数。支付有效时间expireTimeVARCHARN指定订单的支付有效时间（分钟数），超过有效时间用户将无法支付。若不指定该参数则系统默认设置24小时支付有效时间。参数允许设置范围：1-1440区间的整数值，超过1440默认设置1440支付宝：用户扫码后开始计算支付有效时间微信：用户下单后开始计算支付有效时间扫码支付API接口说明回调通知地址notifyurlVARCHARY支付成功失败的通知地址交易终端ipcreateipVARCHARY交易终端IP跳转路径callbackUrlVARCHARN支付成功跳转路径；form表单形式提交商户后台；子商户公众号标识subAppIdVARCHARY子商户公众号标识子商户公众号下关注的用户openidsubOpenIdVARCHARY子商户公众号下关注的用户openid微信子商户号wxSubMchIdVARCHARN微信支付分配的子商户号是否开具电子发票receiptVARCHARN是否开具电子发票是否原生公众号isRawVARCHARY1:原生公众号(返回json串给jsapi拉起支付)备注extend1VARCHARN备注信息，测试系统必填签名signVARCHARYRSA签名4、返回协议参数：参数名参数数据类型必填说明返回状态rspCodeVARCHARY返回的错误码，000000代表成功，其它为失败返回信息rspMsgVARCHARY返回信息支付码信息payCodeVARCHARYpayCode:{\sign\:\D9F4C32B8F20D348DDFA85C95B291E55\,\timestamp\:\1476774382\,\noncestr\:\368c7e90e499484e901edbbd501a8dd9\,\partnerid\:\15233133\,\prepayid\:\wx2016101815033454fd6f1dc10662762955\,\package\:\S