4.1.7服务开通/信用授权查询

使用场景：使用商户外部协议号或开通/授权协议号，查询服务开通/授权信息
接口编号：zhima.credit.payafteruse.creditagreement.query

请求参数（bizdata）：

参数

参数名称

取值

可空

类型

备注

out_agreement_no

商户外部协议号

【描述】商户外部协议号

否

string(32)

out_agreement_no

credit_agreement_id

必填一个

推荐使用credit_agreement_id

credit_agreement_id

开通/授权协议号

【描述】芝麻开通/授权协议号

否

string(128)

响应参数（bizdata）：

参数	参数名称	取值	可空	类型	备注
agreement_status	开通/授权状态	【描述】开通/授权状态 VALID：有效 INVALID：无效	否	string(16)
credit_agreement_id	开通/授权协议号	【描述】芝麻开通/授权协议号	否	string(128)
out_agreement_no	商户外部协议号	【描述】商户外部协议号	是	string(32)
biz_time	开通/授权状态变更的时间	【示例值】2021-01-19 00:00:00	是	string(64)
alipay_user_id	用户ID	【描述】蚂蚁统一会员ID	否	string(64)	alipay_user_id和open_id任选其一传入，必传
open_id	开放ID	【描述】开放ID	否	string(128)
ext_info	扩展字段	【描述】该字段只在特殊业务场景下根据业务方约定返回一般业务场景下不需要消费该字段【示例值】{"key":"value"}	是	string(1024)	分期单协议号获取: ext_info.deductAgreement.GENERAL_WITHHOLDING_P

样例数据：
请求报文:{"out_agreement_no":"agree2088102318125883"}
返回报文:
{"agreement_status":"VALID","biz_time":"2024-06-25 16:52:19","credit_agreement_id":"ZMOP99202406250200880035288485","ext_info":{"deductAgreement":"{"GENERAL_WITHHOLDING_P":"20245425175068923888"}"},"out_agreement_no":"agree2088102318125883","open_id":"0883cFGaAab_fBEtKjki0gYRk21tsDa30R4zTol_uT1ywc7"}

业务错误码

错误码	错误描述	解决方案
SYSTEM_ERROR	系统繁忙	服务器异常可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
INVALID_PARAMETER	参数有误	请根据接口返回的参数非法的具体错误信息，修改参数后进行重试
BIZ_ERROR	业务异常业务异常	稍后重试，或联系技术支持
CREDIT_AGREEMENT_NOT_EXIST	信用服务开通信息不存在	请检查参数是否正确
CREDIT_AUTH_NOT_EXIST	信用服务开通授权信息不存在	请检查请求参数
DEPEND_FAILURE	系统异常	系统异常，请重试
EXTRA_PARAM_FORMAT_ERROR	扩展参数格式错误	请检查扩展参数格式
ILLEGAL_QUERY	查询商户与开通授权信息关联商户不匹配	仅支持查询商户相关的开通授权信息