二、接口配置及参数说明

1.接口地址

沙箱环境地址：https://devapi.smvips.com/api/merchant/index
生产环境地址：https://api.smvips.com/api/merchant/index
ps:部署时请注意地址差异，所有接口都是同一个地址，业务通过各个接口的method参数区分

2.接口请求方式

请求方式：post

接口请求ContentType：application/json

回调/响应ContentType：application/json

3.测试参数

测试商户号：9733732

测试商户密钥：c9d23f1eb7b34a5db5179b09acd07566

测试产品：

产品编码	产品名称	说明
100000	权益、话费等直充-成功测试
100001	权益、话费等直充-失败测试
100002	卡密产品-成功测试
100003	卡密产品-失败测试
100004	游戏产品-成功测试
100005	游戏产品-失败测试

4.关于回调

您可以在下单接口业务参数中的notifyUrl参数传递回调地址，也可以在商户管理中统一配置回调地址，注意下单接口中的回调地址优先级大于统一配置的。

5.接口参数说明

所有业务接口都需要包含一下五个参数：

参数名	是否必须	是否参与签名	说明
appid	是	是	应用id，即商户号
method	是	是	接口方法，每个接口不同，详见各个接口说明
timestamp	是	是	unix时间戳，精确到秒。即北京时间1970-01-01 08:00:00到当前的秒数，平台会通过该参数校验请求有效期，允许与平台时间差异正负五分钟
content	是	是	业务参数，详见各个业务。注意：该参数为json字符串，在接口文档中为了阅读清晰方便，文档结构上显示为json对象，在参与签名、提交接口时一定为json字符串
sign	是	否	签名，签名规则详见签名方式章节

ps：平台中所有涉及金额的单位都是：元

6.MD5与AES对称加密校队

平台使用到了MD5计算和AES对称加解密计算，由于各个商户所使用的开发语言不同，部分开发语言之间做MD5计算和AES加解密计算时可能存在差异。如java的是：AES/ECB/PKCS5Padding，c#的是AES/ECB/PKCS7Padding
为了签名和加解密结果一致,帮助商户排错，这里列出了一段内容供商户进行MD5和AES的计算校队

md5校队
待校队字符串：我是中国人12345ABCefg!@#我是中国人
md5结果：6004742fa70923e934f66fbcd7b56304

aes加解密校队
不同语言之间，算法/模式/补码的具体表述不同，请注意自身语言的算法。
本aes加解密是采用的aes中最简单的ECB模式，不需要偏移量（ps：各个语言之间的默认偏移量也不同）
为了算法一致，可以使用下列参数进行校对。

说明	内容
加解密密钥	`c9d23f1eb7b34a5db5179b09acd07566`
模式	ECB
填充	Pkcs7/Pkcs5
待加密字符串	`我是中国人12345ABCefg!@#我是中国人`
加密结果(BASE64)	`K+EZhhk1+6vOxtLbRfqy1RM1mSyg++w6SG2YNJM7eSePS64JbUH9at63w/yiIB7W`
待解密字符串(BASE64)	`nfVnxoQPaAKx/MMmUBioW4Le1zLUCw+0e5jCVmEX8kE/8SXY9vL6e7/PbSKlOw/e`
解密结果	`格物致知!!2023QWEasd@@格物致知`

C#加解密示例代码

java代码示例（java 1.8.0_144测试的）

7.技术沟通

如遇到技术问题，请联系技术人员或在对接群中进行沟通

1.接口地址#

2.接口请求方式#

3.测试参数#

4.关于回调#

5.接口参数说明#

6.MD5与AES对称加密校队#