员工代扣支付V2¶
使用场景¶
商家与关爱通合作,在商家页面或app内员工下单,会使用员工绑定的资产进行支付
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/seller/quickPayV2
- 生产环境: https://openapi.guanaitong.com/seller/quickPayV2
参数说明¶
-
公有参数
发送请求是必须传入公共参数,详见公共参数
-
私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| buyer_open_id | 是 | string | [10-50] | 下单员工唯一标识 |
| outer_trade_no | 是 | string | [10,30] | 外部交易号,请以appid开头,例如:1000000122 |
| total_amount | 是 | decimal | [0.01,99999999.99] | 代扣金额 |
| asset_code | 否 | string | [1,20] | 资产类型 POINT=积分,QUOTA=额度 |
| asset_open_id | 否 | string | [1,50] | 资产id,额度支付情况下需要 |
| reason | 是 | string | [1,254] | 下单原因 |
| attach | 否 | string | [1,100] | 附加信息 |
| notify_url | 否 | string | [10,500] | 支付通知地址(如果需要的话可以传递) |
请求示例¶
POST: /seller/quickPay HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
access_token=b983eef183a789a693b91406f38b7e23×tamp=1529046657&
buyer_open_id=d87797eea12a2f80ad72ed93214a0908&outer_trade_no=1000567801
&reason=企业代付机票&total_amount=836.34&version=1.0.0
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码 |
| msg | 如果错误,返回错误信息。 |
| data | 如果没有错误,返回业务数据 |
| data.outer_trade_no | 外部交易号,与请求参数[outer_trade_no]相同 |
| data.trade_no | 关爱通支付单号 |
| data.order_amount | 订单金额(不含服务费),与请求参数[total_amount]相同 |
| data.fee_amount | 员工支付的服务费金额 |
| data.avail_balance | 支付完成之后员工剩余可用金额 |