转账申请
接口描述:
转账接口采用加密方式调用,加密机制参见:加密与签名。
出于转账资金安全考虑,转账接口为非实时接口,需要人工参与审批。调用方调用转账接口,接口返回:
1、http状态为 200,即认为 付款单申请成功。
2、http状态为 非200,即认为 付款单申请失败。
接口地址:/{context}/payment/packed
请求方式:POST
consumes:["application/zw-packet"]
produces:["application/zw-packet"]
请求示例:
{
"amount": 0,
"batch": "",
"callerSN": "",
"currency": "",
"scene": "",
"payType": "",
"payload": {
"key": "value"
},
"receivingAccount": "",
"receivingName": "",
"receivingBank": "",
"postscript": ""
}
请求参数
| 参数名称 | 参数说明 | in | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| amount | 转账金额,单位:元 | body | true | number | |
| batch | 批次号或账期 | body | false | string | |
| callerSN | 调用方流水号,如:HIS 流水号 | body | false | string | |
| currency | 交易货币,默认 CNY:人民币 | body | false | string | |
| scene | 场景,默认:1,1:出院结算、2:OA、3:物资采购 | body | false | string | |
| payType | 支付方式,参见: 支付方式代码 | body | true | string | |
| payload | 负载的其它业务数据, JSON 格式 | body | false | object | |
| receivingAccount | 收款账户 | body | true | string | |
| receivingName | 收款户名 | body | true | string | |
| receivingBank | 收款银行/开户行 | body | false | string | |
| postscript | 附言 | body | false | string |
建行银行银企,payType=0690,payload 参数
| 参数名称 | 参数说明 | in | 是否必须 | 数据类型 | schema |
|---|---|---|---|---|---|
| IP | ip地址 | body | true | string | |
| bankSN | 跨行对方账号开户行号 | body | false | string | |
| bankName | 跨行对方账号开户行名 | body | false | string |
建设银行银企基于外联平台,payType=0691,payload 参数
响应示例:
{
"currency": "CNY",
"amount": 0,
"transfer": 0,
"sn": "",
"callerSN": "",
"payType": "",
"paymentAccount": "",
"paymentName": "",
"paymentBank": "",
"receivingAccount": "",
"receivingName": "",
"receivingBank": "",
"scene": "",
"postscript": "",
"createTime": "",
"execTime": "",
"id": 0,
"payload": "",
"state": "",
"message": ""
}
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| currency | 货币 | string | |
| amount | 交易金额,单位:元 | number | |
| transfer | 转账金额,单位:元 | number | |
| sn | 流水号 | string | |
| callerSN | 调用方流水号,如:HIS 流水号 | string | |
| payType | 支付方式,参见:约定字典 | string | |
| paymentAccount | 付款账户 | string | |
| paymentName | 付款户名 | string | |
| paymentBank | 付款银行 | string | |
| receivingAccount | 收款账户 | string | |
| receivingName | 收款户名 | string | |
| receivingBank | 收款银行 | string | |
| scene | 场景,默认:1,1:出院结算、2:OA、3:物资采购 | string | |
| postscript | 附言 | string | |
| execTime | 最近执行时间 | string(date-time) | string(date-time) |
| createTime | 创建时间 | string(date-time) | string(date-time) |
| id | 标识,修改时必须 | integer(int32) | integer(int32) |
| payload | 负载的其它业务数据, JSON 格式 | string | |
| state | 支付状态,0:初始化、1:提交、2:同意、3:转账、4:成功、5:失败、6:待确认、7:已复核、8:作废 | string | |
| message | 消息 | string |
响应状态:
| 状态码 | 说明 | schema |
|---|---|---|
| 200 | OK | |
| 201 | Created | |
| 401 | Unauthorized | |
| 403 | Forbidden | |
| 404 | Not Found |