文档中心 > API类目 > AliOS支付API

aliyun.alios.pay.token.get (获取支付token)

商户用来获取支付的授权token

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
get_token_request GetTokenRequest 可选 请求参数
  • └ original_amount
  • Number
  • 可选
  • 888
  • CP的商品原始金额,不参与任何计算,仅用于展示原始金额
  • └ trace_id
  • String
  • 必须
  • 0b0aad0e15441575065206212d0756
  • 请求唯一id,不可重复,服务端会根据此参数防重放
  • └ token_type
  • String
  • 可选
  • ORDER
  • ORDER订单token,OTHER其他token
  • └ discountable_amount
  • Number
  • 可选
  • 888
  • 参与优惠计算的金额,用此字段用于让订单中部分金额不参与优惠的计算
  • └ total_amount
  • Number
  • 可选
  • 888
  • 订单总金额
  • └ subject
  • String
  • 可选
  • 虾米音乐数字专辑
  • 订单标题
  • └ biz_order_id
  • String
  • 可选
  • 格式由cp自行决定
  • 业务订单号
  • └ time
  • String
  • 必须
  • 1559200938392
  • 请求时间戳
  • └ lang
  • String
  • 必须
  • en
  • 语言,en表示英文,zh表示中文
  • └ period_rule_params
  • String
  • 可选
  • {"external_period_agreement_code": "VIP_RENEWAL","period_type": "DAY","period": 3,"period_execute_time": "20211201","period_single_amount": 888,"period_total_amount": 8888,"period_total_payments": 10}
  • 周期扣款规则参数,周期扣款订单必传。支付系统会按照这里传入的参数提示用户,并对发起扣款的时间、金额、次数等做相应限制
  • └ service_protocol
  • String
  • 可选
  • HTTPS
  • cp服务端支持的协议,目前只支持HTTPS
  • └ period_sign_notify_url
  • String
  • 可选
  • www.tianmaoyangche.com/notify
  • 周期扣款签约结果回调地址
  • └ period_unsign_notify_url
  • String
  • 可选
  • www.tianmaoyangche.com/notify
  • 周期扣款解约结果回调地址
  • └ pay_notify_url
  • String
  • 可选
  • www.tianmaoyangche.com/notify
  • 支付结果回调通知URL

响应参数

名称 类型 示例值 描述
aliospay_response AliOSPayResponse 响应参数
  • └ trace_id
  • String
  • 0b0aad0e15441575065206212d0756
  • 请求唯一id,不可重复,服务端会根据此参数防重放
  • └ code
  • Number
  • 0
  • 错误码
  • └ message
  • String
  • success
  • 错误信息
  • data
  • GetTokenResponse
  • 业务数据
  • └ pay_token
  • String
  • alios-pay-91722adff935e8cfa58b3aabf4dead6ibe
  • 支付token

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliyunAliosPayTokenGetRequest req = new AliyunAliosPayTokenGetRequest();
AliyunAliosPayTokenGetRequest.GetTokenRequest obj1 = new AliyunAliosPayTokenGetRequest.GetTokenRequest();
obj1.setOriginalAmount(888L);
obj1.setTraceId("0b0aad0e15441575065206212d0756");
obj1.setTokenType("ORDER");
obj1.setDiscountableAmount(888L);
obj1.setTotalAmount(888L);
obj1.setSubject("虾米音乐数字专辑");
obj1.setBizOrderId("格式由cp自行决定");
obj1.setTime("1559200938392");
obj1.setLang("en");
obj1.setPeriodRuleParams("{\"external_period_agreement_code\": \"VIP_RENEWAL\",\"period_type\": \"DAY\",\"period\": 3,\"period_execute_time\": \"20211201\",\"period_single_amount\": 888,\"period_total_amount\": 8888,\"period_total_payments\": 10}");
obj1.setServiceProtocol("HTTPS");
obj1.setPeriodSignNotifyUrl("www.tianmaoyangche.com/notify");
obj1.setPeriodUnsignNotifyUrl("www.tianmaoyangche.com/notify");
obj1.setPayNotifyUrl("www.tianmaoyangche.com/notify");
req.setGetTokenRequest(obj1);
AliyunAliosPayTokenGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<aliyun_alios_pay_token_get_response>
    <aliospay_response>
        <trace_id>0b0aad0e15441575065206212d0756</trace_id>
        <code>0</code>
        <message>success</message>
        <data>
            <pay_token>alios-pay-91722adff935e8cfa58b3aabf4dead6ibe</pay_token>
        </data>
    </aliospay_response>
</aliyun_alios_pay_token_get_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部