文档中心 > API类目 > 阿里通信API

alibaba.aliqin.flow.wallet.consume (流量扣减)

流量钱包流量扣减接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
flow Number 必须 1 扣减流量值
serial_no String 必须 test_serial_no 扣减流水号
reason String 可选 大转盘抽奖 扣减原因
remark String 可选 备注 备注

响应参数

名称 类型 示例值 描述
value String true true为成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAliqinFlowWalletConsumeRequest req = new AlibabaAliqinFlowWalletConsumeRequest();
req.setFlow(1L);
req.setSerialNo("test_serial_no");
req.setReason("大转盘抽奖");
req.setRemark("备注");
AlibabaAliqinFlowWalletConsumeResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_aliqin_flow_wallet_consume_response>
    <value>true</value>
</alibaba_aliqin_flow_wallet_consume_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isv.record_has_exists 扣减记录已存在 一个用户下,对于同一个扣减流水号幂等
isv.balance_not_enough 用户余额不足 扣减用户的余额不足,扣减失败
isv.user_none 用户不存在 该用户不是流量钱包的用户

API工具

如何获得此API

FAQ

返回
顶部