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