third order manager

maelk-liu
Commit fd6f9feb266f20dc2751a461906e276463004934 1 parent 696fd2f9
Showing 1 changed file with 125 additions and 1 deletions
线下店/yohobuy-trade.md
--- a/线下店/yohobuy-trade.md
View file @fd6f9fe
+++ b/线下店/yohobuy-trade.md
View file @fd6f9fe
@@ -62,6 +62,21 @@
 | └ body | String | 否 | 1000 | 商品描述信息 | 特价手机 |
 | └ show_url | String | 否 | 400 | 商品的展示地址 http://www.xxx.com/xxx.jpg |
 
+ 请求示例  
+ localhost:8080/gateway?method=yohopay.trade.create
+ ```json  
+ {"body":"好东西啊真是好东西啊","discountable_amount":88.01,"goods_detail":
+ [{"body":"奶茶","goods_id":"naicha123","goods_name":"双拼双色奶茶","price":25,"quantity":4}],
+ "notify_url":"www.baidu.com",
+ "out_trade_no":"YH123456789","subject":"贡茶双拼奶茶","total_amount":100.01,"undiscountable_amount":20,
+ "app_id":1001,
+ "shop_id":1002,
+ "terminal_id":1003,
+ "operator_id":1004
+ }
+ ```
+ 
+ 
 ### 响应参数
 | 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
 | :-- | :-- | :-- | :-- | :-- | :-- |
@@ -69,6 +84,21 @@
 | trade_no | String | 是 | 64 | 有货交易号 | 2015042321001004720200028594 |
 | timeout_express | String | 是 | 6 | 该笔订单允许的最晚付款时间，逾期将关闭交易，格式"yyyyMMddHHmmss"。 | 20140724030750 |
 
+ 响应成功JSON格式如下所示:  
+ ```json  
+ {
+   "alg": "SALT_MD5",
+   "code": 200,
+   "data": {
+     "out_trade_no": "YH123456789",
+     "timeout_express": "20170221134649",
+     "trade_no": "123456789"
+   },
+   "md5": "f7d6e9a1a092a6e0886084b8ba84e78c",
+   "message": "third order create"
+ }
+ ```
+ 
 
 ## yohopay.trade.query (统一收单线下交易查询)
 该接口提供所有支付订单的查询，商户可以通过该接口主动查询订单状态，完成下一步的业务逻辑。 需要调用查询接口的情况： 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知； 调用支付接口后，返回系统错误或未知交易状态情况；
@@ -80,6 +110,15 @@
 | out_trade_no | String | 特殊可选 | 64 | 商户订单号 | 20150423001001 |
 | trade_no | String | 特殊可选 | 64 | 有货交易号 | 2013112011001004330000121536 |
 
+ 请求示例  
+ localhost:8080/gateway?method=yohopay.trade.query
+ ```json  
+ {
+ "out_trade_no":"YH123456789",
+ "trade_no":"123456789"
+ }
+ ```
+ 
 ### 响应参数
 | 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
 | :-- | :-- | :-- | :-- | :-- | :-- |
@@ -91,6 +130,26 @@
 | yoho_coin_amount | Price | 选填 | 11 | 有货币支付金额，单位为元，两位小数。 | 10 |
 
 
+ 响应成功JSON格式如下所示:  
+ ```json  
+ {
+   "alg": "SALT_MD5",
+   "code": 200,
+   "data": {
+     "buyer_pay_amount": 100.01,
+     "out_trade_no": "YH123456789",
+     "total_amount": 100.01,
+     "trade_no": "123456789",
+     "trade_status": "PRE_CREATE",
+     "yoho_coin_amount": 0
+   },
+   "md5": "070ac6b8c48735cdedcd6f4a6deca4f9",
+   "message": "third order query"
+ }
+ ```
+ 
+ 
+ 
 ## yohopay.trade.refund (统一收单交易退款接口)
 当交易发生之后一段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接口将支付款退还给买家，系统将在收到退款请求并且验证成功之后，按照退款规则将支付款按原路退到买家帐号上。总退款金额不能超过用户实际支付金额
 
@@ -112,6 +171,23 @@
 | └ show_url | String | 可选 | 400 | 商品的展示地址 http://www.xxx.com/xxx.jpg |
 | └ refund_reason | String | 是 | 256	退款的原因说明 | 正常退款 |
 
+ 请求示例  
+ localhost:8080/gateway?method=yohopay.trade.refund
+ ```json  
+ {"out_trade_no":"YH123456789",
+ "trade_no":"123456789",
+ "out_request_no":"",
+ "refund_amount":100.01,
+ "refund_reason":"正常退款",
+ "goods_detail":
+ [{"body":"奶茶","goods_id":"naicha123","goods_name":"双拼双色奶茶","price":25,"quantity":4}],
+ "app_id":1001,
+ "shop_id":1002,
+ "terminal_id":1003,
+ "operator_id":1004
+ }
+ ```
+ 
 ### 响应参数
 | 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
 | :-- | :-- | :-- | :-- | :-- | :-- |
@@ -125,6 +201,26 @@
 | gmt_refund_pay | Date | 必填 | 32 | 退款支付时间 | 20141127154557 |
 
 
+ 响应成功JSON格式如下所示:  
+ ```json  
+ {
+   "alg": "SALT_MD5",
+   "code": 200,
+   "data": {
+     "fund_change": "Y",
+     "gmt_refund_pay": "20170221134204",
+     "out_request_no": "",
+     "out_trade_no": "YH123456789",
+     "refund_buyer_pay": 0,
+     "refund_total": 100.01,
+     "refund_yoho_coin": 100.01,
+     "trade_no": "123456789"
+   },
+   "md5": "f5448f1dedf991065c3f140258de3312",
+   "message": "third refund order"
+ }
+ ```
+ 
 ## yohopay.trade.fastpay.refund.query (统一收单交易退款查询)
 商户可使用该接口查询自已通过yohopay.trade.refund提交的退款请求是否执行成功。
 
@@ -134,6 +230,14 @@
 | out_trade_no | String | 特殊可选 | 64 | 商户订单号 | 2014112611001004680073956707 |
 | trade_no | String | 特殊可选 | 64 | 有货交易号 | 20150320010101001 |
 | out_request_no | String | 否 | 64 | 标识一次退款请求，同一笔交易多次退款需要保证唯一，如需部分退款，则此参数必传。 |
+ 请求示例  
+ localhost:8080/gateway?method=yohopay.trade.fastpay.refund.query
+ ```json  
+ {"out_trade_no":"YH123456789",
+ "trade_no":"123456789",
+ "out_request_no":"",
+ }
+ ```
 
 ### 响应参数
 | 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
@@ -145,4 +249,24 @@
 | refund_total | Price | 必填 | 11 | 退款总金额 | 88.88 |
 | refund_buyer_pay | Price | 必填 | 11 | 退用户实付金额 | 15.25 |
 | refund_yoho_coin | Price | 必填 | 11 | 退用户有货比支付金额 | 10 |
- | gmt_refund_pay | Date | 必填 | 32 | 退款支付时间 | 20141127154557 |
\ No newline at end of file
+ | gmt_refund_pay | Date | 必填 | 32 | 退款支付时间 | 20141127154557 |
+ 
+ 响应成功JSON格式如下所示:  
+ ```json  
+ {
+   "alg": "SALT_MD5",
+   "code": 200,
+   "data": {
+     "fund_change": "Y",
+     "gmt_refund_pay": "1487655724",
+     "out_request_no": "",
+     "out_trade_no": "YH123456789",
+     "refund_buyer_pay": 100.01,
+     "refund_total": 100.01,
+     "refund_yoho_coin": 0,
+     "trade_no": "123456789"
+   },
+   "md5": "880bb5eeb6452f32679cb0d3827b6eae",
+   "message": "third refund query"
+ }
+ ```