小米应用商店：红包系统独立商户接口文档

小提示：您能找到这篇{小米应用商店：红包系统独立商户接口文档}绝对不是偶然，我们能帮您找到潜在客户，解决您的困扰。如果您对本页介绍的小米应用商店：红包系统独立商户接口文档内容感兴趣，有相关需求意向欢迎拨打我们的服务热线，或留言咨询，我们将第一时间联系您！

< ">1 功能描述

< ">提供cashpay-red-package-s媒体危机公关5s通用原则ervice HTTPS服务接口。

< ">< font-size: 18px;">2 数据交互

< ">1.构造请求数据。合作方服务端根据请求参数要求（见3）构造请求数据。

< ">2.发送请求数据。通过HTTP POST方法发送数据。

< ">3.现金支付中心对请求数据进行处理。

< ">4.返回处理的数据结果。

< ">现金支付中心处理完成之后将处理结果以JSON形式返回给合作方。

< ">5.合作方对返回的结果数据进行处理。

< ">接口URL

< ">Staging:http://staging.redpack.pay.xiaomi.com/redPackage

< ">Product:https://redpack.pay.xiaomi.com/redPackage

< ">< font-size: 18px;">3 商户红包HTTPS接口

< ">3.1.1领和拆商户红包

< ">3.1.1.1 Url

< ">POST redPackage/open/out/getAndOpenMerchantRedPackage

< ">3.1.1.2 参数

< ">3.1.1.3 返回值

< ">3.1.2查询商户红包

< ">3.1.2.1 Url

< ">POST redPackage/open/out/queryRedPackageOrder

< ">3.1.2.2参数

< ">3.1.2.3返回值

< ">3.1.3查询红包列表

< ">3.1.3.1 Url

< ">POST redPackage/open/out/queryMerchantRedPackageList

< ">3.1.3.2参数

< ">3.1.3.3返回值

< ">packageList参数说明：

< ">3.1.4查看用户详情

< ">3.1.4.1 Url

< ">POST redPackage/open/out/queryMerchantUserDetail

< ">3.1.4.2参数

< ">3.1.4.3返回值

< ">3.1.5创建商户定向红包

< ">3.1.5.1 Url

< ">POST redPackage/open/out/createMerchantDirectRedPackage

< ">3.1.5.2参数

< ">3.1.5.3返回值

< ">3.1.6发布商户定向红包

< ">3.1.6.1 Url

< ">POST redPackage/open/out/publishAndSendMerchantDirectRedPackage

< ">3.1.6.2参数

< ">3.1.6.3返回值

< ">3.1.7创建商户常规红包

< ">3.1.7.1 Url

< ">POST redPackage/open/out/createMerchantNormalRedPackage

< ">3.1.7.2参数

< ">3.1.7.3返回值

< ">3.1.8发布商户常规红包

< ">3.1.8.1 Url

< ">POST redPackage/open/out/publishAndSendMerchantNormalRedPackage

< ">3.1.8.2参数

< ">3.1.8.3返回值

< ">< font-size: 18px;">4 返回数据处理

< ">4.1返回数据处理

< ">支付中心处理合作方商户请求后，立刻返回处理结果。

< ">处理结果的格式为JSON格式

< ">4.2 Errcode定义

< ">SUCCESS=200;//成功

< ">ERROR=201;

< ">INTERNAL_SERVICE_ERROR=1100001;//系统内部错误

< ">RSA_VERIFY_SIGN_ERROR=1100006;//验签错误

< ">PARAMETER_ERROR=2100001;//参数错误

< ">RED_PACKAGE_PAY_FAILED=2100002;//红包支付失败

< ">QUERY_USER_INFO_ERROR=2100003;//用户信息不存在

< ">GET_ACCOUNT_INFO_ERROR=2100004;//用户账户错误

< ">USER_ACCOUNT_FROZE_ERROR=2100005;//用户冻结错误

< ">PACKAGE_REPEAT_RECEIVE_ERROR=2100006;//红包重复领取

< ">GET_RED_PACKAGE_ORDER_ERROR=2100007;//领红包订单错误

< ">RED_PACKAGE_RECEIVE_OVER_ERROR=2100008;//红包已领完

< ">ALREADY_EXIST_ERROR=2100009;//红包已存在

< ">SEND_COUNT_OVER_LIMIT=2100010;//发红包次数超限

< ">SEND_AMOUNT_OVER_LIMIT=2100011;//发红包金额超限

< ">RECEIVE_COUNT_OVER_LIMIT=2100012;//领红包次数超限

< ">RECEIVE_AMOUNT_OVER_LIMIT=2100013;//领红包金额超限

< ">RED_PACKAGE_WAIT_PAY=2100015;//红包未支付

< ">RED_PACKAGE_FINISHED=2100016;//红包已结束

< ">USER_NOT_VERIFIED_ERROR=2010017;//用户未实名

< ">OPEN_RED_PACKAGE_ERROR=2010018;//拆红包错误

< ">QUERY_RED_PACKAGE_ERROR=2010019;//红包查询错误

< ">GET_RED_PACKAGE_ERROR=2010020;//获取红包失败

< ">RED_PACKAGE_EXPIRED_ERROR=2010021;//红包已过期错误

< ">RECEIVER_NOT_ALLOWED_ERROR=2010022;//红包接收者不允许

< ">RECEIVER_EQUALS_SENDER_ERROR=2010023;//不能给自己发红包

< ">RED_PACKAGE_STATUS_ERROR=2100024//红包状态错误

< ">公共错误：200 201 1100001 1100006 2100001

< ">创建红包相关：2100002 2100003 2100004 2100005 2100009 2100010 2100011 2010017

< ">抢红包相关：2100006 2100007 2100008 2100012 2100013 2010018 2010020 2010021 2引流新方法100002 2100015 2100016 2100024

< ">查询红包相关：2010019

< ">< font-size: 18px;">5 签名与加密机制

< ">5.1签名算法

< ">合作方请求和支付中心结果返回都会对参数做签名，目前签名算法仅支持使用RSA。

< ">密钥生成和签名算法如下。

< ">5.2签名方式

< ">1.请求参数列表和返回参数列表中的所有参数，除sign和signType不参与，其他参数均需要签名，如果参数值为空则不参与签名且不需要传递，所有参与签名的参数值均为原始字符串，不需要做urlencode。

< ">2.生成待签名的字符串

< ">对于需要签名的参数数组，先对参数按照key进行排序，排序规则将数组中每个key按照ASCII从小到大排列，然后将key，value以如下形式进行组合：key1=v1&key2=v2，所生成的字符串即为待签名的字符串。例如：

< ">benefitUserId=110000&createTime=1388487642&notifyUrl=http://oneboxhost/mock/notify&outTransferId=48794928118907008081&partnerId=10000001&transferAmount=1

< ">5.3加密算法

< ">合作方请求和支付中心返回都会对敏感参数做加密，目前加密算法仅支持使用RSA。使用和签名同样的公钥、秘钥对。

< ">请求时，合作方使用支付中心提供的公钥对参数加密。

< ">< font-size: 18px;">6 返回代码及描述

< ">TODO