关于支付业务接口功能有哪些呢？功能接口的参数呢？
各种支付的功能接口定律都差不多，比如 支付路由 有4个重要的参数：订单号，交易流水号，金额，时间。
1. 说明
一般支付涉及4个接口(公司的项目)：
1.订单下单接口
2.订单回调接口
3.订单再支付接口
4.订单商品查询接口
2.功能接口
2.1订单下单接口
2.1.1描述
接口描述：
用户选择完商品后，发起下单操作， 业务平台收到订单后，插入整体的订单表与具体业务商品的明细表， 根据请求的支付路由要求，请求支付网关， 返回支付网关的支付页面链接，让用户在页面上面进行支付。
方法名：自定义
应用场景：在用户选择完商品后，发起订单交易
2.1.2 交互流程和应用场景
略
2.1.3 请求参数
字段 含义 类型 长度 必填 备注
order_info 订单信息 json M 订单信息
gateway_info 支付路由信息 json M 支付的路由信息
goods_info 商品信息 json M 商品信息
2.1.3.1 各参数定义
order_info
字段 含义 类型 长度 必填 备注
trans_amount 订单金额 n M
trans_time 订单时间 n M
gateway_info
字段 含义 类型 长度 必填 备注
gateway_id 网关id an M
channel_id 支付渠道id an M
return_url 业务完成跳转地址 an M
goods_info
这个字段根据实际的业务情况组成商品信息
2.1.4. 应答参数
字段 含义 类型 长度 必填 备注 payment_info 支付的信息 json数组 M
payment_info组定义
字段 含义 类型 必填 pay_id 支付订单号 an M trans_nbr 交流流水号 an M pay_url 支付跳转的url an M
2.1.5. 报文示例
请求参数
{
"header":{
….
}
" body ":{
"order_info":{
"trans_amount": 100,
"trans_time": "20180901000000",
},
"gateway_info":{
"gateway_id": "g001",
"channel_id": "c001",
"return_url": "https://www.paymnet.com:14334/id?"
},
"goods_info":{
"phoneno": "15609812222",
"product_id": "p001",
"product_name": "浙江50元流量包"
}
}
}
返回参数
{
"errorCode ":"",
"errorMsg ":"",
“success“： true,
"message ":{
“pay_id”:"aaaaaaa0001",
"trans_nbr":"78322aaaaa"
"pay_url": "https://123.44.3.4:34343/payment?id=ddddd"
}
}
2.1订单回调接口
2.1.1描述
接口描述： 根据支付网关的回调，对订单进行处理。
方法名：自定义
应用场景：支付网关进行回调
2.1.2. 交互流程
略
2.1.3. 请求参数
字段 含义 类型 长度 必填 备注 trans_nbr 业务流水号 an M 订单完成后的流水号 trans_amount 订单金额 n M trans_time 订单交易时间 n M gateway_id 网关id a M channel_id 渠道id a M state 状态 n M 0:成功 其它：失败 comments 说明 a M 对于状态的说明 state_time 状态时间 n M 状态时间
2.1.4. 应答参数
回调通知，不要要应答
2.1.5. 报文示例
{ "header":{ …. } " body ":{ "trans_nbr":"a0001" "trans_amount":100, "trans_time": "20180901000000", "gateway_id":"g0001", "channel_id":"c0001", "state": 2 , "comments": "订单超时", "state_time": "20180901000000" } }
返回参数
无
2.1订单再支付接口
2.1.1描述
接口描述：对已经发起订单，但是还没有支付完成，同时还在支付时间内的订单，再次发起支付
方法名： 自定义 应用场景： 对订单列表中，支付没有完成，进行再次支付
2.1.2. 交互流程
略
2.1.3. 请求参数
字段 含义 类型 长度 必填 备注
trans_nbr 订单流水号 ans M
gateway_info 支付路由信息 json串 M
gateway_info组定义
字段 含义 类型 长度 必填 备注
gateway_id 网关id an M
channel_id 支付渠道id an M
return_url 业务完成跳转地址 an M
2.1.4. 应答参数
字段 含义 类型 长度 必填 备注
payment_info 支付的信息 json数组 M
payment_info组定义
字段 含义 类型 必填 pay_id 支付订单号 an M trans_nbr 交流流水号 an M pay_url 支付跳转的url an M
2.1.5. 报文示例
{ "header":{ …. } " body ":{ "trans_nbr": "201232132", "gateway_info":{ "gateway_id": "g001", "channel_id": "c001", "return_url": "https://www.paymnet.com:14334/id?" } } }
返回参数
{ "errorCode ":"", "errorMsg ":"", “success“： true, "message ":{ “pay_id”:"aaaaaaa0001", "trans_nbr":"78322aaaaa" "pay_url": "https://123.44.3.4:34343/payment?id=ddddd" } }
2.1 订单商品查询接口
2.1.1描述
接口描述：根据订单编号查询对应的订单商品信息
方法名： 自定义 应用场景：对订单列表中的详细订单中显示
2.1.2. 交互流程
略
2.1.3. 请求参数
字段 含义 类型 长度 必填 备注 trans_nbr 业务id ans M 业务id pay_id 支付id号 ans M 支付id号
2.1.4. 应答参数
字段 含义 类型 长度 必填 备注
order_info 订单信息 json数组 M
goods_info 订单商品信息 json数组 M
order_info组定义
字段 含义 类型 必填 备注 trans_nbr 业务流水号 ans M 订单完成后的流水号 trans_amount 订单金额 n M trans_time 订单交易时间 n M pay_time 支付时间 n M gateway_comment 网关id an channel_comment 渠道id an order_no 网关流水号 an state 状态 n M 1:等待支付 2: 完成订单 3: 取消订单 4: 订单处理中 state_time 状态时间 n M 状态时间
goods_info组定义
这个字段根据实际的业务情况组成商品信息
2.1.5. 报文示例
请求参数
{ "header":{ …. } " body ":{ "business_id":"a0001" } }
响应参数
{ "errorCode ":"", "errorMsg ":"", “success“： true, "message ":{ "order_info":{ “pay_id”:"aaaaaaa0001", "trans_nbr":"78322aaaaa", "state": 1, "state_time": "20180630010101" ...... ...... }, "goods_info":{ "phoneno": "15609812222", "product_id": "p001", "product_name": "浙江50元流量包" } } }