接口规范(通用)

(版本号 v3.0.0)

*所有提交参数均为小写

网关地址：https://api.dayspay.org/

1 接入事项

1.1 接入地址

Content-Type:

第 1 页/共 10 页
协 议 头 application/x-www-form-

urlencoded;charset=UTF-8

2 通讯签名算法

签名生成的通用步骤如下：
 参数按照字段名的 ascii 码从小到大排序后使用 QueryString 的格式（即
key1=value1&key2=value2…）拼接而成。
 将以上的参数拼接字符串后面追加＆key=privateKey。
 最后将结果字符串做 md5 后，转换成小写，得到签名 sign。
 即 MD5 签名计算公式：sign = MD5(原字符串&key=密钥)
 签名后的 MD5 值使用小写字符串
 请注意 空参数 不参与签名。

2.1 测试商户信息

测试商户 ID : 1
测试商户密匙: TzibzxkYFG7e3TEPwEjTyQQfdJacp6tB

第 2 页/共 10 页
 3 接口

3.1 法定货币支付

3.1.1 请求

3.1.2 网关地址/api/v3/payment

NO 参数名称 参数含义 必填 数据类型 说明

1. partnerid 商户编号 Y String(20) 由我司提供。
amount Y string *字符串类型 “20.00” 请保留 2 位
2. 交易金额
小数
3. notifyurl 回调地址 Y String(255) 异步通知地址
orderid 商户方订单 N String(225) 单号 请保持唯一性
4.
号
5. remark 备注 N String(255)
6. sign 签名 Y String(100) *参考头部 签名生成 规则
{

 "status": 200,
 "msg": "",
 "url": "https://pay.jamestest.ga/#/pages/pay/index?
返回结果 money=1000&orderid=111234&partnerid=1&channel=4"

status 201: 无可用通道 请联系客服处理

第 3 页/共 10 页
错误代 202:创建支付失败, 保证单号唯一
码 203:sign 验证失败!

3.2 异步回调

3.2.1 接收查询状态回调(商户方回调)

请贵方 自行制作接收回调的地址. 接收以下 POST 方法 参数 并在请求支付 notifyurl

参数中填写贵方制作好的回调地址 我方会已 JSON 结构请求您的接口.
回调测试参数

{
"category":"1",
"status":"1",
"msg":"备注信息",
"orderid":"PAY20200917132304kr7svvj10",
"sign":"34d2d5f1da6c446dfe4fdcf4223eb7cc",
"amount":"100.00"

第 4 页/共 10 页
}
参数名称 参数含义 数据类型 说明
category 回调类别 String(1) 0 支付回调
1 代付回调

amount 金额 String(20) 回调金额

status 支付状态 String(2) 1：交易成功

2：交易失败
msg 支付结果描 String(20) code 响应码对应的
述 信息
orderid 订单号 String(32) 唯一订单号
sign String(100) 订单生成的 SIGN 参考头部 签名生成
签名
规则
此接口为 支付方 向商户发送支付(代付)状态回调,
acde3f99d659d8e750cca60707503bfd
接收到回调 请以 JSON 结构 返回

{"code":200,"msg":
"ok"}

Partnerorder 为特殊用户使用 普通用户可忽略

3.3 API 查询订单状态

网关地址/api/v3/query

第 5 页/共 10 页
 3.3.1 请求

NO 参数名称 参数含义 必填 数据类型 说明

1. orderid 订单号 Y String(32) 唯一单号

2. partnerid Y String(30) 由我司提供。

商户编号

sign Y String(100) 通过签名算法计算

3. 得出
签名
数据库中请求支付
加密后 SIGN
备
所有参数名称均为小写. JSON 方式提交
注

3.3.2 返回

NO 参数名称 参数含义 必填 数据类型 说明

status 支付状态 Y String(2) 1：交易成功
1. 2：交易失败
3: 订单不存在
0: 处理中
2. msg Y String(20) code 响应码对应的信
支付结果描述
息
3. amount Y String
交易金额

 "amount": "111111.00",
返
 "status": "1",
回
 "msg": "交易成功"

第 6 页/共 10 页
 3.4 代付接口

3.4.1 请求代付

网关地址/api/v3/withdraw
参数名称 参数含义 必填 数据类型 说明
partnerid 商户 ID Y String(20) 由我司提供。
1

2 orderid 订单号 Y String(32) 请求方提供，务必保证唯一性

3 amount 交易金额 Y String(20) *100.00 保留两位小数。
cardnumber Y String(255) 银行卡号 如果是虚拟币 请填写对
4 账号
应地址
accountname 收款人姓 N String(255) 收款人名称 虚拟币可不填写
5
名
bankname 代付银行 Y String(255) 银行名称
6

notifyurl 回调 Y String(255) 回调代付成功使用

7
URL
8 remark 备注 N String（255） 备注信息
sign Y String(100) *可以在数据库中保存请求的
9 签名
SIGN 以接收我方回调确认
返回结果
{

 "status": 3,
 "msg": "余额不足"

}
NO 参数名称 参数含义 必填 数据类型 说明
status 结果代码 Y String(10) 1：提交成功
1. 2：失败
3: 余额不足
2. msg 结果描述 Y String(255) 结果描述

第 7 页/共 10 页
 3.4.2 查询代付结果

网关地址/api/v3/querywithdraw
NO 参数名称 参数含义 必填 数据类型 说明
4. orderid 订单号 Y String(32) 请求方提供，务必保证
唯一性。
5. partnerid Y String(30) 由我司提供。
商户编号

sign Y String(100) 通过签名算法计算

6. 得出
签名
数据库中请求支付
加密后 SIGN
备
所有参数名称均为小写. JSON 方式提交
注
返回结果
NO 参数名称 参数含义 必填 数据类型 说明
status 支付状态 Y Int(2) 1：交易成功
4. 2：交易失败
3: 订单不存在
0: 处理中
5. msg Y String(20) code 响应码对应的信
支付结果描述
息
6. amount N String
交易金额

 "amount": "111111.00",
返
 "status": "2",
回
 "msg": ""

3.5 查询余额接口

网关地址/api/v3/checkbalance

第 8 页/共 10 页
 参数名称 参数含义 必填 数据类型 说明
partnerid 商户 ID Y String(20) 由我司提供。
1

2 sign 签名 Y String(100)
返回结果
{

 "status": 3,
 "data": 10000.00

}
NO 参数名称 参数含义 必填 数据类型 说明

3.5.1 查询代付结果

网关地址/api/v3/querywithdraw
NO 参数名称 参数含义 必填 数据类型 说明
7. orderid 订单号 Y String(32) 请求方提供，务必保证
唯一性。
8. partnerid Y String(30) 由我司提供。
商户编号

sign Y String(100) 通过签名算法计算

9. 得出
签名
数据库中请求支付
加密后 SIGN
备
所有参数名称均为小写. JSON 方式提交
注
返回结果
NO 参数名称 参数含义 必填 数据类型 说明
status 支付状态 Y Int(2) 1：交易成功
7. 2：交易失败
3: 订单不存在
0: 处理中
8. msg Y String(20) code 响应码对应的信
支付结果描述
息
9. amount N String
交易金额

返 {

第 9 页/共 10 页
  "amount": "111111.00",
 "status": "2",
回
 "msg": ""

第 10 页/共 10 页