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

 

 

 

 

 

 

　　

       

 

转载于:https://www.cnblogs.com/PinkPink/p/9519710.html