转账申请
接口描述:
转账接口采用加密方式调用,加密机制参见:加密与签名。
出于转账资金安全考虑,转账接口为非实时接口,需要人工参与审批。调用方调用转账接口,接口返回:
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 |