2、沙箱参数与接口规则说明

1.沙箱商户后台

沙箱环境提供了手动回调、查看回调json相关功能，可以在商户中心【交易>我的全量订单】，点击订单详情进行查看。

沙箱地址：https://devvip.nvframe.com/

沙箱账号：sandbox

沙箱密码：sandbox123

2.接口地址

沙箱环境地址：https://devapi.nvframe.com/api/merchant/index

生产环境地址：https://?????/api/merchant/index (请联系我司运营或技术提供)

特别提醒：部署生产环境时，请注意修改为生产环境地址，所有接口都是同一个地址，业务是通过各个接口的method参数区分的

3.网络协议及编码格式

请求方式：post

接口请求ContentType：application/json

回调/响应ContentType：application/json

编码格式：UTF8（请注意提交或返回的响应，以及计算md5时，编码格式都是UTF8）

4.测试参数

测试商户号：9733732

测试商户密钥：c9d23f1eb7b34a5db5179b09acd07566

测试产品：

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

5.关于回调

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

6.接口参数说明

除回调接口外，所有请求我司的接口，都需要包含以下五个参数：

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

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

7.MD5与AES对称加密校队

由于不同的开发语言，使用的默认编码格式或算法不同，可能在计算MD5和AES对称加解密时和平台不一致，导致签名不通过或解密失败，所以下面提供了平台对演示字符的md5计算结果或aes加解密结果，开发者可对接相关字符进行计算，看结果是否一致，如果不一致那可能就是编码格式或算法差异。

md5校对

AES加解密校队
【1】不同语言之间，AES的算法/模式/补码的具体表述不同，请注意自身语言的算法参数。
如java为：AES/ECB/PKCS5Padding；c#为：AES/ECB/PKCS7Padding
本AES加解密是采用的AES中最简单的ECB模式，不需要偏移量（ps：各个语言之间的默认偏移量也不同），密钥长度为32位字符串，java的版本较低时，可能默认只支持16位密钥，需要支持到32位，需要额外配置，请注意处理。
【2】校对参数

说明	内容
加解密密钥	`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测试的）

8.技术沟通

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

1.沙箱商户后台#

2.接口地址#

3.网络协议及编码格式#

4.测试参数#

5.关于回调#

6.接口参数说明#

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

8.技术沟通#