博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
支付业务接口功能(二)
阅读量:4679 次
发布时间:2019-06-09

本文共 6402 字,大约阅读时间需要 21 分钟。

 

关于支付业务接口功能有哪些呢?功能接口的参数呢?

各种支付的功能接口定律都差不多,比如 支付路由 有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.1描述

接口描述:根据订单编号查询对应的订单商品信息 方法名: 自定义应用场景:对订单列表中的详细订单中显示

2.1.2. 交互流程

2.1.3. 请求参数

字段	        含义    类型  长度  必填	备注trans_nbr	业务id	ans	   M	业务idpay_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

你可能感兴趣的文章
Jquery 事件 DOM操作
查看>>
运算符
查看>>
FIR滤波器的verilog实现方法
查看>>
display的值和对应的意义
查看>>
HashSet、LinkHashSet、TreeSet总结
查看>>
手机号码输入格式化,数字三三四的输入;手机正则校验输入是否合理及提示;...
查看>>
抽象类
查看>>
CSS3 背景
查看>>
WPF DataGrid 之数据绑定
查看>>
c语言之gdb调试。
查看>>
位反转的最佳算法
查看>>
常用面试问题
查看>>
第一个爬虫
查看>>
Java面试知识点之Java基础
查看>>
老外的前端面试题
查看>>
架构:新浪架构师谈微博架构
查看>>
SQL 语句速查
查看>>
discuz 删除指定条件的资讯
查看>>
Android上下文菜单ContextMenu
查看>>
JavaScript Number 对象 Javascript Array对象 Location 对象方法 String对象方法
查看>>