关于支付业务接口功能有哪些呢?功能接口的参数呢?
各种支付的功能接口定律都差不多,比如 支付路由 有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元流量包"
}
}
}