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

aliyun.alios.pay.period.agreement.pay (周期扣款支付接口)

周期扣款支付接口,商户服务端通过该接口完成后续期数的支付

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
period_agreement_pay_request PeriodAgreementPayRequest 可选 请求参数
  • └ trace_id
  • String
  • 必须
  • 0b0aad0e15441575065206212d0756
  • 请求唯一id,不可重复,服务端会根据此参数防重放
  • └ lang
  • String
  • 必须
  • en
  • 语言,en表示英文,zh表示中文
  • └ time
  • String
  • 必须
  • 1559200938392
  • 请求时间戳
  • └ biz_order_id
  • String
  • 必须
  • 格式由cp自行决定,长度限定64位
  • 业务订单号
  • └ subject
  • String
  • 必须
  • 虾米音乐数字专辑
  • 订单标题
  • └ total_amount
  • Number
  • 必须
  • 888
  • 订单总金额,单位为分
  • └ external_period_agreement_code
  • String
  • 必须
  • 15fcd70c3609746b95ef10b211a5dde8
  • 外部商户周期扣款签约码,周期扣款协议中标示用户的唯一签约编号(确保在商户系统中唯一)。格式规则:支持大写小写字母和数字,最长32位
  • └ service_protocol
  • String
  • 可选
  • HTTPS
  • cp服务端支持的协议,目前只支持HTTPS
  • └ pay_notify_url
  • String
  • 可选
  • www.tianmaoyangche.com/notify
  • 支付结果回调通知URL

响应参数

名称 类型 示例值 描述
aliospay_response AliOSPayResponse 响应参数
  • └ trace_id
  • String
  • 0b0aad0e15441575065206212d0756
  • 请求唯一id,不可重复,服务端会根据此参数防重放
  • └ code
  • Number
  • 0
  • 错误码
  • └ message
  • String
  • success
  • 错误信息
  • data
  • PeriodAgreementPayResponse
  • 业务数据
  • └ pay_order_id
  • String
  • 2013112011001004330000121536
  • 斑马支付单Id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliyunAliosPayPeriodAgreementPayRequest req = new AliyunAliosPayPeriodAgreementPayRequest();
AliyunAliosPayPeriodAgreementPayRequest.PeriodAgreementPayRequest obj1 = new AliyunAliosPayPeriodAgreementPayRequest.PeriodAgreementPayRequest();
obj1.setTraceId("0b0aad0e15441575065206212d0756");
obj1.setLang("en");
obj1.setTime("1559200938392");
obj1.setBizOrderId("格式由cp自行决定,长度限定64位");
obj1.setSubject("虾米音乐数字专辑");
obj1.setTotalAmount(888L);
obj1.setExternalPeriodAgreementCode("15fcd70c3609746b95ef10b211a5dde8");
obj1.setServiceProtocol("HTTPS");
obj1.setPayNotifyUrl("www.tianmaoyangche.com/notify");
req.setPeriodAgreementPayRequest(obj1);
AliyunAliosPayPeriodAgreementPayResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<aliyun_alios_pay_period_agreement_pay_response>
    <aliospay_response>
        <trace_id>0b0aad0e15441575065206212d0756</trace_id>
        <code>0</code>
        <message>success</message>
        <data>
            <pay_order_id>2013112011001004330000121536</pay_order_id>
        </data>
    </aliospay_response>
</aliyun_alios_pay_period_agreement_pay_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

返回
顶部