商品收费启用或停用接口

更新时间：
以 Markdown 格式查看 LLM请查看llms.txt

接口说明

接口名称：alipay.aipay.nowpay.charge.modify

启用或停用商品的新增购买能力。支持将已停用商品重新启用，或将已启用商品停用；商品原有有效权益仍按权益查询结果使用。

支持已获授权的第三方代理调用。所有接口由平台服务端调用。

适用场景

  • 创作者暂停商品新增购买。
  • 已停用商品恢复新增购买。

注意事项

  • action 仅支持 ENABLE、DISABLE；接口不修改价格、档位、额度数量或权益有效期，也不撤销已发放权益。
  • 只对已完成配置且处于可启停状态的商品操作。若已处于目标状态，返回 changed=false，仍表示本次请求成功。
  • 超时后先调用 charge.query 确认现状；必要时重试原 action。不要直接提交相反动作作为补偿。

公共请求参数

参数类型是否必选最大长度描述示例值
app_idString必选32支付宝分配给开发者的应用IDYOUR_APP_ID
methodString必选128接口名称alipay.aipay.nowpay.charge.modify
formatString可选40仅支持JSONJSON
charsetString必选10请求使用的编码格式，如utf-8,gbk,gb2312等utf-8
sign_typeString必选10请求签名算法，推荐 RSA2RSA2
signString必选344商户请求参数的签名串，详见签名详见示例
timestampString必选19发送请求的时间，格式”yyyy-MM-dd HH:mm
”		2026-09-07 10:00:00
versionString必选3调用的接口版本，固定为：1.01.0
app_auth_tokenString可选40已获授权的第三方代调用场景使用的应用授权令牌，详见应用授权概述-
biz_contentString必选-业务请求参数的 JSON 字符串，字段使用 snake_case；详见下表-

业务请求参数

业务字段统一放入 biz_content。下表数组子字段使用 [] 表示元素路径。

参数类型是否必选最大长度描述注意事项/枚举值示例值
out_product_idString必选128平台内稳定的商品或应用标识-app_writing_001
external_owner_idString必选128平台内稳定的创作者或商品所有者标识与配置时使用的标识一致；不是必须填写支付宝账号creator_001
actionString必选32修改类型，ENABLE/DISABLE开启:ENABLE；关闭:DISABLEDISABLE

常见请求示例

示例商品、用户、域名及请求号均为演示值。Java 使用包含该接口请求类的支付宝服务端 SDK；示例按公钥模式初始化，私钥仅保存在平台服务端。cURL 中的签名需在发送前按全部实际参数生成；如增加 app_auth_token，应一起参与签名。

import com.alipay.api.AlipayConfig;
import com.alipay.api.AlipayClient;
import com.alipay.api.DefaultAlipayClient;
import com.alipay.api.request.AlipayAipayNowpayChargeModifyRequest;
import com.alipay.api.response.AlipayAipayNowpayChargeModifyResponse;

public class NowpayExample {
    public static void main(String[] args) throws Exception {
        AlipayConfig config = new AlipayConfig();
        config.setServerUrl("https://openapi.alipay.com/gateway.do");
        config.setAppId(System.getenv("ALIPAY_APP_ID"));
        config.setPrivateKey(System.getenv("ALIPAY_PRIVATE_KEY"));
        config.setAlipayPublicKey(System.getenv("ALIPAY_PUBLIC_KEY"));
        config.setFormat("json");
        config.setCharset("UTF-8");
        config.setSignType("RSA2");
        AlipayClient client = new DefaultAlipayClient(config);

        AlipayAipayNowpayChargeModifyRequest request = new AlipayAipayNowpayChargeModifyRequest();
        request.setBizContent("{\"out_product_id\":\"app_writing_001\",\"external_owner_id\":\"creator_001\",\"action\":\"DISABLE\"}");
        // 仅在已获授权的第三方代调用场景设置 app_auth_token。
        String appAuthToken = System.getenv("ALIPAY_APP_AUTH_TOKEN");
        if (appAuthToken != null && !appAuthToken.isEmpty()) {
            request.putOtherTextParam("app_auth_token", appAuthToken);
        }
        AlipayAipayNowpayChargeModifyResponse response = client.execute(request);
        if (!response.isSuccess()) {
            // 按 code/sub_code 处理；结果未知时保留原业务请求号。
            System.out.println(response.getCode() + ":" + response.getSubCode());
            return;
        }
        // 网关成功后，按本页“结果处理”读取业务字段。
        System.out.println(response.getBody());
    }
}
biz_content='{
  "out_product_id": "app_writing_001",
  "external_owner_id": "creator_001",
  "action": "DISABLE"
}'

# app_id、timestamp、sign 由平台准备；sign 必须基于本次完整参数生成。
curl --request POST 'https://openapi.alipay.com/gateway.do' \
  --data-urlencode "app_id=${app_id}" \
  --data-urlencode 'method=alipay.aipay.nowpay.charge.modify' \
  --data-urlencode 'format=json' \
  --data-urlencode 'charset=UTF-8' \
  --data-urlencode 'sign_type=RSA2' \
  --data-urlencode "timestamp=${timestamp}" \
  --data-urlencode 'version=1.0' \
  --data-urlencode "biz_content=${biz_content}" \
  --data-urlencode "sign=${sign}"

公共响应参数

参数类型是否必选最大长度描述示例值
codeString必选-网关返回码；10000 表示接口调用成功10000
msgString必选-网关返回码说明Success
sub_codeString可选-业务错误码；仅用于接口失败处理-
sub_msgString可选-业务错误说明；不用于编写固定业务分支-
signString必选-响应签名，位于响应根对象；由 SDK 按配置验签-

响应业务对象名为 alipay_aipay_nowpay_charge_modify_response。先完成验签并判断 code，再读取业务结果。

业务响应参数

参数类型是否必选最大长度描述注意事项/枚举值示例值
capability_statusString必选128商品收费能力状态ENABLED / DISABLEDDISABLED
status_versionNumber可选32最新状态版本-2
changedBoolean必选10是否实际发生状态变化-true
reason_messageString可选32用于展示的状态说明--

结果处理

code=10000 后读取 capability_status 确认目标状态。changed=false 表示此前已经处于目标状态，不应当作失败。操作失败或结果未知时，使用 查询收费能力和档位 重新查询。

响应示例

以下为按单一业务场景整理的示例。签名、链接令牌和二维码均为占位值，不可直接使用。

{
  "alipay_aipay_nowpay_charge_modify_response": {
    "code": "10000",
    "msg": "Success",
    "capability_status": "DISABLED",
    "status_version": 2,
    "changed": true
  },
  "sign": "RESPONSE_SIGNATURE_PLACEHOLDER"
}
{
  "alipay_aipay_nowpay_charge_modify_response": {
    "code": "20000",
    "msg": "Service Currently Unavailable",
    "sub_code": "isp.unknow-error",
    "sub_msg": "系统繁忙"
  },
  "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

公共错误码

参见支付宝公共错误码。网关或系统异常时，按原请求查询或重试；写操作不能在结果未确认时更换幂等号。

业务错误码

以下保留当前开放平台预览已列出的错误码，并补充平台处理建议。错误码列表可能扩展，平台应保留未知错误的待确认处理。

错误码错误描述解决方案
SYSTEM_ERROR系统繁忙稍后使用原参数重试；消费结果未知时先查询原请求
INVALID_PARAMETER参数有误请根据接口返回的参数非法的具体错误信息，修改参数后进行重试
NOW_PAY_BINDING_NOT_FOUND未找到绑定的商品请确认相关商品已配置上架
NOW_PAY_CAPABILITY_CHANGE_FAIL商品变更失败：当前状态不允许变更请确认商品最新状态