扫码支付API接口说明文档.docVIP

. .. 扫码支付API接口开发指南 商户接口规范 版本(3.0.7) 修订时间：2017-08-01 目录 TOC \o 1-3 \h \z \u HYPERLINK \l _Toc12501 第一章 文档描述 PAGEREF _Toc12501 3 HYPERLINK \l _Toc15479 1、 文档说明 PAGEREF _Toc15479 3 HYPERLINK \l _Toc24957 2、 阅读对象 PAGEREF _Toc24957 3 HYPERLINK \l _Toc29143 3、 名词定义 PAGEREF _Toc29143 3 HYPERLINK \l _Toc31989 第二章 接口定义 PAGEREF _Toc31989 3 HYPERLINK \l _Toc14280 1、 扫码支付 PAGEREF _Toc14280 3 HYPERLINK \l _公众号支付2、 公众号支付 PAGEREF _Toc14280 3 HYPERLINK \l _支付异步通知3、 支付异步通知 PAGEREF _Toc190 10 HYPERLINK \l _交易查询4、 交易查询 PAGEREF _Toc20412 12 HYPERLINK \l _对账查询5、 对账查询 PAGEREF _Toc25234 14 HYPERLINK \l _Toc29269 第三章签名说明 PAGEREF _Toc29269 12 HYPERLINK \l _Toc21290 1、 签名算法 PAGEREF _Toc21290 12 HYPERLINK \l _Toc1405 2、 密钥生产 PAGEREF _Toc1405 12 HYPERLINK \l _Toc8321 附录1错误码说明 PAGEREF _Toc8321 14 文档描述 文档说明 本说明文档用于指导商户接入扫码支付API系统进行的对接，目前支持支付宝、微信扫码。请相关技术人员详细阅读本文档。 阅读对象 商户开发人员。 扫码支付API接口相关技术人员。 名词定义 合作方：指对接扫码支付平台的机构。 商户：指委托收单的营业机构，如超市、便利店等。 用户：指在商户系统内进行消费的企业或者个人。 商户ID： 指支付系统为使用外部接入接口的商户统一分配的唯一标识。 商户密钥：指商户在和支付系统进行数据签名认证的密钥，采用RSA加密算法。 接口定义 扫码支付 接入URL： 5:8088/payservice/pay/smzf 接入方式：POST方式均可 请求协议参数： 参数名 参数 数据类型 必填 说明 订单ID orderId VARCHAR Y 交易订单ID 支付通道 payType VARCHAR Y 支付通道：WXZF-微信支付，ZFBZF-支付宝支付 商户编码 merchantCode VARCHAR Y 商户编码，接入时系统分配 交易金额 totalAmount VARCHAR Y 交易金额，单位：元，最小2元 交易标题 subject VARCHAR Y 交易标题，显示在微信或支付宝支付页面 交易描述 desc VARCHAR Y 交易描述 商户操作员id operatorId VARCHAR N 操作员编号，如员工编码 门店编号 storeId VARCHAR N 商户的门店编号 商户终端编号 terminalId VARCHAR Y 商户机器的终端编号 支付方式 limitPay VARCHAR N 微信/支付宝： 1-不能使用信用卡 支付宝： 2-不适用花呗 3-不使用信用卡/花呗 来源信息 source VARCHAR N 支付宝分配给下游的pid识别号，2088开头的一串16位数字,对应支付宝的sys_service_provider_id字段 商品标记 goodsTag VARCHAR N 微信渠道可选上送，代金券或立减优惠功能参数，对应微信的goods_tag字段 支付宝目前用不到该参数。 支付有效时间 expireTime VARCHAR N 指定订单的支付有效时间（分钟数），超过有效时间用户将无法支付。若不指定该参数则系统默认设置24小时支付有效时间。参数允许设置范围：1-1440区间的整数值，超过1440默认设置1440 支付宝：用户扫码后开始计算支付有效时间 微信：用户下单后开始计算支付有效时间 回调通知地址 notifyurl VARCHAR Y 支付成功失败的通知地址 交易终端ip createip VARCHAR Y 交易终端IP 备注 extend1 VARCHAR N 备注信息，测试系统必填 签名 sign VARCHAR Y RSA签名 返回协议参数： 参数名