用途:诊断某客户或订阅的支付失败原因,查询网关错误码、翻译为通俗英文并推荐修复方案。
主要能力:通过 ZohoBilling_Search_Customers 解析客户并获取 customer_id;用 ZohoBilling_List_all_Subscriptions 按 PAST_DUE 过滤订阅;用 ZohoBilling_Get_Payment_Failures_Report 获取失败详情;用 ZohoBilling_Search_Error_Categories 解码错误码;用 ZohoBilling_Get_Subscriptions_Dunning_Report 查看催收状态。输出包含订阅、上次尝试、错误码、错误含义、根因、推荐修复步骤和催收状态。
使用方式:输入客户名、订阅或错误码。若为空会询问要诊断哪个客户或订阅。错误类别对应处理建议:卡过期/无效卡→请客户更新卡;余额不足→稍后重试或提供分期;Do not honour→客户需联系银行;卡被盗/欺诈标记→不要重试,改用其他渠道联系;技术/网关错误→立即重试。
限制:仅提出建议,不执行支付重试或订阅变更;必须用 Search_Error_Categories 翻译错误码;不得只说“检查网关”而不给出具体动作。错误码未找到时显示原始码并提示升级至支付运营;同一客户多次失败显示最近3次及日期;无 PAST_DUE 订阅时提示未发现失败支付。