API接口使用帮助

API列表
SUP进货业务(特别提醒:下游对接请看销售系统/API进货业务部分)
订单增加API >

通过订单增加API接口,可以向SUP增加订单的工作。


订单状态查询API >

提供了SUP订单状态的查询。


账户余额查询API >

提供了SUP账户余额的查询。


目录列表 >

提供了SUP商品的目录信息的查询。


充值类型列表 >

提供了SUP某些游戏的充值类型信息的查询。


程序自动兼容SUP和销售系统两个接口 >

提供了同时兼容SUP和销售系统2个系统的API的参数的对比说明。


SUP供货业务
获取订单信息API >

提供了SUP供货商获取订单信息的接口。


订单处理API >

通过SUP订单处理API接口,可以处理SUP中的订单状态。


修改商品上下架/库存API >

通过SUP修改商品上下架/库存接口,可以修改商品上下架状态和库存状态。


销售系统进货业务
订单增加API >

通过订单增加API接口,可以向销售系统增加订单的工作。


订单状态查询API >

提供了销售系统订单状态的查询。


账户余额查询API >

提供了销售系统账户余额的查询。


查询所有商品列表API >

提供了销售系统所有商品列表的查询。


查询指定商品详情API >

提供了销售系统指定商品详情的查询。


查询全部目录API >

提供了销售系统全部目录的查询。


有关签名Sign参数的详细说明

本文档中心所有提到的"数字签名","MD5","md5"等名词均可以此部分文档说明为准。 其中提到的"key","密钥","接口密钥"均为你的商家密钥,由你的对接人提供。


签名方式为根据对应接口的签名参数说明部分把对应参数的用字符串拼接的方式连接后进行md5加密,要求输出32位结果,大小写均可。 参数本身不参与签名 ,也不需要用&或者=符号或者其他任何多余字符拼接。
有关参数排序:需要严格按照文档说明中各参数值的次序排列,不要进行自动排序。


如果参数值有中文,请不要编码,直接参与md5加密,不过在加密方法中要用utf-8对整个明文字符串进行编码。


举例1:
比如获取商户余额的接口提到sign=MD5(MerchantID+ key),假设你的商户id是12345,你的商户密钥是2566c3789a1a8272b30aeb91a195190。那么这个接口的签名参数就是对"123452566c3789a1a8272b30aeb91a195190"进行md5加密后的结果:5aed2e8faad3954ee5b45bbdbd22fc06。如果你的加密结果不相符请检查md5方法,也可以通过网址http://md5jiami.bmcx.com/进行验证。


举例2:参数值有中文的情况
比如增加订单的接口提到sign=MD5(MerchantID+Catagory+BuyNumber+ChargeAccount+商户密钥),其中ChargeAccount可能包含中文,假设商户id是12345,你的商户密钥是2566c3789a1a8272b30aeb91a195190,购买的商品目录是100,购买数量99,充值帐号是"你好易约"。那么这个接口的签名参数就是对"1234510099你好易约2566c3789a1a8272b30aeb91a195190"进行md5加密后的结果:ab4e1555b244dbc211bd88c948db2848。如果你的加密结果不相符请检查md5方法,也可以通过网址http://md5jiami.bmcx.com/进行验证。


C#进行md5参数的方法示范:

public string MD5Encrypt(string pvSource)
{
byte[] lvBytes = Encoding.UTF8.GetBytes(pvSource);
MD5 lvMd5 = new MD5CryptoServiceProvider();
byte[] lvRes = lvMd5.ComputeHash(lvBytes);
return BitConverter.ToString(lvRes).Replace("-", "").ToLower();
}