通用场景
周期性扣款产品,商户延期扣款接口
公共请求参数
业务请求参数
agreement_no必选string(20)
【描述】周期性扣款产品,授权免密支付协议号
【示例值】20185909000458725113
deduct_time必选date(10)
【描述】商户下一次扣款时间
【示例值】2019-05-12
memo可选string(64)
【描述】具体修改原因
【示例值】用户已购买半年包,需延期扣款时间
常见请求示例
默认示例
alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipayuseragreementexecutionplanmodifyrequest request = new alipayuseragreementexecutionplanmodifyrequest();
request.setbizcontent("{"
"\"agreement_no\":\"20185909000458725113\","
"\"deduct_time\":\"2020-05-12\","
"\"memo\":\"用户已购买半年包,需延期扣款时间\""
" }");
alipayuseragreementexecutionplanmodifyresponse response = alipayclient.execute(request);
if(response.issuccess()){
system.out.println("调用成功");
} else {
system.out.println("调用失败");
}
说明:本示例仅供参考。
公共响应参数
业务响应参数
agreement_no必选string(20)
【描述】周期性扣款产品,授权免密支付协议号
【示例值】20185909000458725113
deduct_time必选date(10)
【描述】商户下一次扣款时间,格式 "yyyy-mm-dd"。
例如:用户在1月1日开通了连续包月,使用了10天又另行购买了“季度包”,如果此时商户希望“季度包”立即优先生效,在季度包结束后能继续使用连续包月,那么原定的周期就被延后了。此时可以通过本接口将预计扣款时间推后“季度包”的时长。
【示例值】2020-05-12
响应示例
正常示例
异常示例
{
"alipay_user_agreement_executionplan_modify_response": {
"code": "10000",
"msg": "success",
"agreement_no": "20185909000458725113",
"deduct_time": "2020-05-12"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息,修改参数后进行重试 |
illegal_agreement | 无效的用户协议 | 无效的用户协议 |
illegal_execution_time | 执行计划时间参数非法 | 传入的时间格式不对,或者传入的时间在下一期执行计划之前,则不允许修改 |