管理后台
供派娜(PayAny)聚合支付SaaS平台用户的员工进行管理合同、商户、终端、订单、退款、争议、运单、提现、报表等。
{platform}为manager。
商户
通常表示一个客户的账户单元。一个合同下可以有不限制数量的商户,即每个客户可以创建N个商户号。每个商户号下的交易、退款、运单等相互独立。
创建
为指定的合同下新增一个商户。
请求地址:/merchant/create
请求谓词:POST
请求主体:
名称 | 类型 | 长度 | 必须 | 说明 |
---|---|---|---|---|
contractId | 数值 | 是 | 合同编号 当前准备新增的商户隶属的合同 | |
name | 文本 | 50 | 是 | 名称 便于识别和记忆为目的的命名 |
level | 数值 | [限定范围] | 是 | 级别 0常规 1信任 |
settleCurrency | 文本 | 3 | 是 | 结算币种 ISO三位大写货币字母代码,如人民币CNY,美元USD |
settleType | 数值 | [限定范围] | 是 | 结算方式 0固定 1动态 |
settleDelay | 数值 | >=0 | 是 | 基础结算周期 |
integrateModes | 数值 | [限定范围] [可多选] | 是 | 集成方式 多选为&位运算,如:1&2,结果为3 0无 1直连 2托管 |
响应主体:
名称 | 类型 | 必须 | 说明 |
---|---|---|---|
数值 | 是 | 当前创建商户的编号 |
响应示例:
{ "status":200, "message":"ok", "data":1231231, "timestamp":1218154088000}
编辑-基础信息
对指定的商户进行信息修改。
请求地址:/merchant/update/{id}
请求谓词:PUT
请求主体:
名称 | 类型 | 长度 | 必须 | 说明 |
---|---|---|---|---|
id | 数值 | 是 | 商户编号 为URL路径的一部分,非GET参数 | |
name | 文本 | 50 | 是 | 名称 以便于识别和记忆为目的的命名 |
level | 数值 | [限定范围] | 是 | 级别 参考创建处声明 |
settleType | 数值 | [限定范围] | 是 | 结算方式 参考创建处声明 |
settleDelay | 数值 | >=0 | 是 | 基础结算周期 |
integrateModes | 数值 | [限定范围] [可多选] | 是 | 集成方式< 参考创建处声明 |
响应主体:
名称 | 类型 | 必须 | 说明 |
---|---|---|---|
布尔 | 是 | true表示编辑成功 false表示编辑失败 |
响应示例:
{ "status":200, "message":"ok", "data":true, "timestamp":1218154088000}
编辑-状态
对指定的商户进行修改状态。
请求地址:/merchant/set/{id}
请求谓词:PUT
请求主体:
名称 | 类型 | 长度 | 必须 | 说明 |
---|---|---|---|---|
id | 数值 | 是 | 商户编号 为URL路径的一部分,非GET参数 | |
status | 数值 | [限定范围] | 是 | 状态 0正常 1暂停(能浏览查询,也可以申请提现) 2冻结(只能浏览查询) |
响应主体:
名称 | 类型 | 必须 | 说明 |
---|---|---|---|
布尔 | 是 | true表示编辑成功 false表示编辑失败 |
响应示例:
{ "status":200, "message":"ok", "data":true, "timestamp":1218154088000}
详情
获取指定的商户的详细信息。
请求地址:/merchant/get/{id}
请求谓词:GET
请求参数:
名称 | 类型 | 长度 | 必须 | 说明 |
---|---|---|---|---|
id | 数值 | 是 | 商户编号 为URL路径的一部分,非GET参数 |
响应主体:
名称 | 类型 | 必须 | 说明 |
---|---|---|---|
id | 数值 | 是 | 商户编号 |
contractId | 数值 | 是 | 隶属的合同编号 |
name | 文本 | 是 | 名称 |
level | 数值 | 是 | 级别 参考创建处声明 |
settleCurrency | 文本 | 是 | 结算币种 |
settleType | 数值 | 是 | 结算方式 参考创建处声明 |
settleDelay | 数值 | 是 | 基础结算周期 |
integrateModes | 数值 | 是 | 集成方式 参考创建处声明 |
status | 数值 | 是 | 状态 参考编辑处声明 |
dateCreated | 时间 | 是 | 创建时间 |
dateUpdated | 时间 | 否 | 最后变更时间 |
响应示例:
{ "status":200, "message":"ok", "data":{ "id":11223344, "contractId":12345678, "name":"YF001", "level":1, "settleCurrency":"CNY", "settleType":"0", "settleDelay":1, "integrateModes":3, "status":0, "dateCreated":"2008-08-08T18:18:18", "dateUpdated":null }, "timestamp":1218154088000}
列表
以分页形式提供商户筛选的列表。
请求地址:/merchant/list/{pageIndex}-{pageSize}
请求谓词:GET
请求参数:
名称 | 类型 | 长度 | 必须 | 说明 |
---|---|---|---|---|
pageIndex | 数值 | >=1 | 是 | 分页页码 为URL路径的一部分,非GET参数 |
pageSize | 数值 | 1~100 | 是 | 分页容量,建议20 为URL路径的一部分,非GET参数 |
contractId | 数值 | 否 | 合同编号 | |
merchantId | 数值 | 否 | 商户编号 | |
name | 文本 | 否 | 商户名称 | |
level | 数值 | 否 | 级别 | |
status | 数值 | 否 | 状态 | |
dateStart | 时间 yyyy-mm-dd hh:mm:ss | 否 | 起始时间,包含 如:2008-08-08 08:08:08 | |
dateEnd | 时间 yyyy-mm-dd hh:mm:ss | 否 | 截止时间,包含 如:2018-10-18 18:18:18 |
响应主体:
名称 | 类型 | 必须 | 说明 |
---|---|---|---|
pageIndex | 数值 | 是 | 分页页码 |
pageSize | 数值 | 是 | 分页容量 |
totalPageCount | 数值 | 是 | 总页数 |
totalItemCount | 数值 | 是 | 总记录数 |
items | 集合 | 是 | 对象集合,可以为空 |
items[].id | 数值 | 是 | 商户编号 |
items[].contractId | 数值 | 是 | 隶属的合同编号 |
items[].name | 文本 | 是 | 名称 |
items[].level | 数值 | 是 | 级别 参考创建处声明 |
items[].settleCurrency | 文本 | 是 | 结算币种 |
items[].settleType | 数值 | 是 | 结算方式 参考创建处声明 |
items[].settleDelay | 数值 | 是 | 基础结算周期 |
items[].integrateModes | 数值 | 是 | 集成方式 参考创建处声明 |
items[].status | 数值 | 是 | 状态< 参考编辑处声明 |
items[].dateCreated | 时间 | 是 | 创建时间 |
items[].dateUpdated | 时间 | 否 | 最后变更时间 |
响应示例:
{ "status":200, "message":"ok", "data":{ "pageIndex":1, "pageSize":20, "totalPageCount":100, "totalItemCount":1998, "items":[ { "id":11223344, "contractId":12345678, "name":"YaoFeng001", "level":1, "settleCurrency":"CNY", "settleType":"0", "settleDelay":1, "integrateModes":3, "status":0, "dateCreated":"2008-08-08T18:18:18", "dateUpdated":null }, //.... ] }, "timestamp":1218154088000}