匡佳华 / API-Interfaces · Commits

Go to a project

Authored by LUOXC
Commit b1b912d8700cd5d8827d48a509c9df8d674a05d9 1 parent e04fbd44

update

Inline Side-by-side
Showing 1 changed file with 32 additions and 14 deletions
... ... @@ -10,6 +10,8 @@
| :-- | :-- | :-- | :-- | :-- | :-- |
| app_id | String | 是 | 32 | 分配给开发者的应用ID | 2014072300007148 |
| shop_id | String | 是 | 32 | 商户门店编号 | 1001 |
| terminal_id | String | 是 | 32 | 商户机具终端编号 | 1001 |
| operator_id | String | 是 | 28 | 商户操作员编号 | 1001 |
| method | String | 是 | 128 | 接口名称 | yohopay.trade.create |
| charset | String | 否 | 10 | 仅支持utf-8 | utf-8 |
| sign | String | 是 | 256 | 请求参数的签名串，详见签名 | 详见示例 |
... ... @@ -23,6 +25,20 @@
| md5 | String | 是 | - | 相应参数MD5值 fd4ad5fcsa0de589af23234ks1923ks |
| data | JSON | 否 | - | 业务执行成功数据包 |
## yohopay.terminal.register (商户机具终端注册)
商户通过该接口进行机具终端的注册
### 请求参数：
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
| :-- | :-- | :-- | :-- | :-- | :-- |
| method | String | 是 | 128 | 接口名称 | yohopay.terminal.register |
| terminal_name | String | 是 | 64 | 商户机具终端名称 | POS01 |
### 响应参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
| :-- | :-- | :-- | :-- | :-- | :-- |
## yohopay.trade.create (统一收单交易创建接口)
商户通过该接口进行交易的创建下单
... ... @@ -30,26 +46,28 @@
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
| :-- | :-- | :-- | :-- | :-- | :-- |
| method | String | 是 | 128 | 接口名称 | yohopay.trade.create |
| out_trade_no | String | 必须 | 64 | 商户订单号,64个字符以内、只能包含字母、数字、下划线；需保证在商户端不重复 |
| out_trade_no | String | 是 | 64 | 商户订单号,64个字符以内、只能包含字母、数字、下划线；需保证在商户端不重复 |
| notify_url | String | 否 | 256 | 服务器主动通知商户服务器里指定的页面http/https路径。 | http://api.test.xxx.net/atinterface/receive_notify.htm |
| total_amount | Price | 必须 | 9 | 订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000] | |
| subject | String | 必须 | 256 | 订单标题 | Iphone6 16G |
| total_amount | Price | 是 | 9 | 订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000] 如果同时传入了【打折金额】，【不可打折金额】，【订单总金额】三者，则必须满足如下条件：【订单总金额】=【打折金额】+【不可打折金额】 | 88.88 |
| discountable_amount | Price | 否 | 9 | 可打折金额. 参与优惠计算的金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000] 如果该值未传入，但传入了【订单总金额】，【不可打折金额】则该值默认为【订单总金额】-【不可打折金额】 | 8.88 |
| undiscountable_amount | Price 否 | 9 | 不可打折金额. 不参与优惠计算的金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000] 如果该值未传入，但传入了【订单总金额】,【打折金额】，则该值默认为【订单总金额】-【打折金额】 | 80.00 |
| subject | String | 是 | 256 | 订单标题 | Iphone6 16G |
| body | String | 可选 | 128 | 对交易或商品的描述 | Iphone6 16G |
| goods_detail | GoodsDetail [] | 可选 | - | 商品列表信息.Json格式. 详见：“商品明细说明” | |
| └ goods_id | String | 必填 | 32 | 商品的编号 | apple-01 |
| └ goods_name | String | 必填 | 256 | 商品名称 | ipad |
| └ quantity | Number | 必填 | 10 | 商品数量 | 1 |
| └ price | Price | 必填 | 9 | 商品单价，单位为元 | 2000 |
| └ goods_category | String | 可选 | 24 | 商品类目 | 34543238 |
| └ body | String | 可选 | 1000 | 商品描述信息 | 特价手机 |
| └ show_url | String | 可选 | 400 | 商品的展示地址 http://www.xxx.com/xxx.jpg |
| goods_detail | GoodsDetail [] | 否 | - | 商品列表信息.Json格式. 详见：“商品明细说明” | |
| └ goods_id | String | 是 | 32 | 商品的编号 | apple-01 |
| └ goods_name | String | 是 | 256 | 商品名称 | ipad |
| └ quantity | Number | 是 | 10 | 商品数量 | 1 |
| └ price | Price | 是 | 9 | 商品单价，单位为元 | 2000 |
| └ goods_category | String | 否 | 24 | 商品类目 | 34543238 |
| └ body | String | 否 | 1000 | 商品描述信息 | 特价手机 |
| └ show_url | String | 否 | 400 | 商品的展示地址 http://www.xxx.com/xxx.jpg |
### 响应参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
| :-- | :-- | :-- | :-- | :-- | :-- |
| out_trade_no | String | 必填 | 64 | 商户订单号 | 20150423001001 |
| trade_no | String | 必填 | 64 | 有货交易号 | 2015042321001004720200028594 |
| timeout_express | String | 必填 | 6 | 该笔订单允许的最晚付款时间，逾期将关闭交易，格式"yyyyMMddHHmmss"。 | 20140724030750 |
| out_trade_no | String | 是 | 64 | 商户订单号 | 20150423001001 |
| trade_no | String | 是 | 64 | 有货交易号 | 2015042321001004720200028594 |
| timeout_express | String | 是 | 6 | 该笔订单允许的最晚付款时间，逾期将关闭交易，格式"yyyyMMddHHmmss"。 | 20140724030750 |
... ...