zhima.merchant.creditservice.detail.create(芝麻信用信用服务创建) 在线调试(沙箱环境)

商户创建信用服务,需要调用此接口,包括两种模式:间连模式和直连模式。

公共参数

请求地址

环境HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do

公共请求参数

参数 类型 是否必填最大长度描述示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 zhima.merchant.creditservice.detail.create
format String 40 仅支持JSON JSON
charset String 10 请求使用的编码格式,如utf-8,gbk,gb2312等 utf-8
sign_type String 10 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 RSA2
sign String 344 商户请求参数的签名串,详见签名 详见示例
timestamp String 19 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 2014-07-24 03:07:50
version String 3 调用的接口版本,固定为:1.0 1.0
app_auth_token String 40 详见应用授权概述
biz_content String 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
solution_id String 必选 64 行业解决方案ID,为必传字段。 solution_003
smid String 可选 64 二级商户ID。如果创建模式为间连模式,此为必传字段;如果为直连模式,不可将此字段赋值作为入参传入。 2088821147142060
biz_no String 必选 256 业务流水号,由商户传入,为必传字段。 123
create_type String 必选 64 信用服务创建模式,为必传字段,可取值:direct(直连模式);indirect(间连模式)。 direct
base_info_config BaseInfoConfig 必选 信用服务基础信息配置,为必传字段。此字段为复杂模型,其中服务名称和服务logo为必传属性。
service_name String 必填 64 信用服务名称,为必传字段。 有电充电宝
logo String 必填 1024 信用服务logo地址,为必传字段,需为合法的链接。 https://mdn.alipayobjects.com/afts/img/pqzzuBTXSeel5fWkzDqTLQAAACMAAQQD/original?bz=creadit_mtls
contact_phone String 可选 32 商户联系人电话,需为合法的电话号码。 15092838833
contact_email String 可选 128 商户联系人邮箱,需为合法的邮箱。 qinyu.zx@antfin.com
risk_config RiskConfig 必选 信用服务风控配置,为必传字段。此字段为复杂模型,其中类目code为必传属性。
category_risks CategoryRiskInfo[] 必填 类目风控信息列表,为必传字段。此字段为复杂模型,其中类目code为必传属性。
category_code String 必填 256 风控类目code,为必传字段 ZMSC_1_1_1
category_name String 可选 256 风控类目名称 类目名称1
score Number 可选 8 芝麻分准入门槛。低于服务使用门槛的消费者将不能使用该品类的服务,推荐填写550分,建议填写范围550~850。 500
risk_policy String 可选 16 综合风险评估,可取值:A1(高准入,满足芝麻分的情况下,通过率在90%以上);A2(中准入,满足芝麻分情况下,通过率在80%以上);A3(低准入,满足芝麻分情况下,通过率在60%以上)。 A1
global_orders_limit_number Number 可选 16 消费笔数上线。代表一个顾客在所有与芝麻信用合作的商户中,可同时享受该产品类信用服务的订单数量,推荐值为2,最多不超过5。 5
global_quota_switch Boolean 可选 8 全局限额开关,可取值true和false。关闭后,当顾客在所有与芝麻信用合作的商户中,未结束的订单减免金额总额即便达到拦截阈值时,也可继续享受信用服务。 true
part_deposit_switch Boolean 可选 8 额度部分免开关,可取值true和false。
关闭后,当顾客的可免额度小于所需费用时,顾客不可使用可免额度,需全部用资金支付。
true
quota_gradient_rule QuotaGradientRule 可选 全局分段限额配置
score_400 Number 可选 16 芝麻分350-400限额 500
score_450 Number 可选 16 芝麻分400-450限额 500
score_500 Number 可选 16 芝麻分450-500限额 500
score_550 Number 可选 16 芝麻分500-550限额 500
score_600 Number 可选 16 芝麻分550-600限额 500
score_650 Number 可选 16 芝麻分600-650限额 500
score_700 Number 可选 16 芝麻分650-700限额 500
score_750 Number 可选 16 芝麻分700-750限额 500
score_800 Number 可选 16 芝麻分750-800限额 500
score_850 Number 可选 16 芝麻分800-850限额 500
score_900 Number 可选 16 芝麻分850-900限额 500
score_950 Number 可选 16 芝麻分900-950限额 500
promise_config PromiseConfig 必选 信用服务守护配置,为必传字段。此字段为复杂模型,其中商户服务电话为必传属性。
merchant_service_phone String 必填 32 商户客服电话,为必填字段,需为合法电话号码。 15092838383
money_operation_type String 可选 32 待还款的守约方式,可取值:promise_link(跳转到去守约页面完成守约);promise_remind(文字提醒守约)。 promise_link
money_operation_value String 可选 1024 待还款守约方式的取值,值为去守约页面的url或者说明文案。 alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index
product_operation_type String 可选 32 待还物的守约方式,可取值:promise_link(跳转到去守约页面完成守约);promise_remind(文字提醒守约)。 promise_link
product_operation_value String 可选 1024 待还物守约方式的取值,值为去守约页面的url或者说明文案。 alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index
action_operation_type String 可选 32 提醒用户完成行为的守约方式,可取值:promise_link(跳转到去守约页面完成守约);promise_remind(文字提醒守约)。 promise_link
action_operation_value String 可选 1024 提醒用户完成行为的守约方式的取值,值为去守约页面的url或者说明文案。 alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index
merchant_service_url String 可选 1024 商户主页链接,取值为商户小程序地址或H5页面地址。 alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index
button_end String 可选 1024 信用服务履约单提前结束按钮的url alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index
button_postpone String 可选 1024 信用服务履约单延期按钮的url alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index
button_replace String 可选 1024 信用服务履约单换新按钮的url alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index
button_buy String 可选 1024 信用服务履约单买断按钮的url alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index
button_repair String 可选 1024 信用服务履约单维修按钮的url alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index
button_installment String 可选 1024 信用服务履约单分期按钮的url alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index
fulfillment_days Number 可选 16 合约履约周期,以天为单位。 5
extra_info String 可选 1024 创建信用服务扩展字段,为JSON字符串。 {"accessPlatform":"webPage","url":"https://zhima.alipay.com/index.htm"}

响应参数

参数 类型 是否必填 最大长度 描述 示例值
credit_service_id String 选填 64 信用服务ID,是成功创建信用服务的ID。 2019022300000001000000000600
version_no String 选填 16 信用服务版本号,是成功创建信用服务的版本号。 1

请求示例

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
ZhimaMerchantCreditserviceDetailCreateRequest request = new ZhimaMerchantCreditserviceDetailCreateRequest();
request.setBizContent("{" +
"\"solution_id\":\"solution_003\"," +
"\"smid\":\"2088821147142060\"," +
"\"biz_no\":\"123\"," +
"\"create_type\":\"direct\"," +
"\"base_info_config\":{" +
"\"service_name\":\"有电充电宝\"," +
"\"logo\":\"https://mdn.alipayobjects.com/afts/img/pqzzuBTXSeel5fWkzDqTLQAAACMAAQQD/original?bz=creadit_mtls\"," +
"\"contact_phone\":\"15092838833\"," +
"\"contact_email\":\"qinyu.zx@antfin.com\"" +
"    }," +
"\"risk_config\":{" +
"        \"category_risks\":[{" +
"          \"category_code\":\"ZMSC_1_1_1\"," +
"\"category_name\":\"类目名称1\"," +
"\"score\":500," +
"\"risk_policy\":\"A1\"," +
"\"global_orders_limit_number\":5," +
"\"global_quota_switch\":true," +
"\"part_deposit_switch\":true" +
"          }]," +
"\"quota_gradient_rule\":{" +
"\"score_400\":500," +
"\"score_450\":500," +
"\"score_500\":500," +
"\"score_550\":500," +
"\"score_600\":500," +
"\"score_650\":500," +
"\"score_700\":500," +
"\"score_750\":500," +
"\"score_800\":500," +
"\"score_850\":500," +
"\"score_900\":500," +
"\"score_950\":500" +
"      }" +
"    }," +
"\"promise_config\":{" +
"\"merchant_service_phone\":\"15092838383\"," +
"\"money_operation_type\":\"promise_link\"," +
"\"money_operation_value\":\"alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index\"," +
"\"product_operation_type\":\"promise_link\"," +
"\"product_operation_value\":\"alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index\"," +
"\"action_operation_type\":\"promise_link\"," +
"\"action_operation_value\":\"alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index\"," +
"\"merchant_service_url\":\"alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index\"," +
"\"button_end\":\"alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index\"," +
"\"button_postpone\":\"alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index\"," +
"\"button_replace\":\"alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index\"," +
"\"button_buy\":\"alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index\"," +
"\"button_repair\":\"alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index\"," +
"\"button_installment\":\"alipays://platformapi/startapp?appId2019022163288247&page=/pages/user/barrel/index\"," +
"\"fulfillment_days\":5" +
"    }," +
"\"extra_info\":\"{\\\"accessPlatform\\\":\\\"webPage\\\",\\\"url\\\":\\\"https://zhima.alipay.com/index.htm\\\"}\"" +
"  }");
ZhimaMerchantCreditserviceDetailCreateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

{
    "zhima_merchant_creditservice_detail_create_response": {
        "code": "10000",
        "msg": "Success",
        "credit_service_id": "2019022300000001000000000600",
        "version_no": "1"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

{
    "zhima_merchant_creditservice_detail_create_response": {
        "code": "20000",
        "msg": "Service Currently Unavailable",
        "sub_code": "isp.unknow-error",
        "sub_msg": "系统繁忙"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

业务错误码

公共错误码

错误码错误描述解决方案
INVALID_PARAMETER 参数有误 参数有误,请根据错误信息提示检查相应参数是否合法
SYSTEM_ERROR 系统繁忙 系统繁忙,请稍后重试
INVALID_PARAMETER 参数有误,参数不能编辑 参数不能编辑,请根据错误信息提示确认入参是否可编辑
SOLUTION_NOT_EXIST 行业解决方案不存在 行业解决方案不存在,请检查行业解决方案是否存在
LOGO_URL_IS_ILLEGAL 商户logo链接不合法 商户logo链接不合法,请输入符合afts链接的商户logo
CATEGORY_NOT_MATCH 风控类目不属于当前行业解决方案 风控类目不属于当前行业解决方案,请输入对应的风控类目
CATEGORY_NOT_EXIST 类目不存在,无法映射到芝麻标准类目 类目不存在,无法映射到芝麻标准类目,请检查输入的类目是否正确
SCORE_IS_NULL 芝麻分准入配置不能为空 芝麻分准入配置不能为空,请对芝麻分准入进行配置
RISK_POLICY_IS_NULL 综合风险策略不能为空 综合风险策略不能为空,请对综合风险策略进行配置
TIMES_SINGLE_IS_ILLEGAL 限笔数必须大于0 限笔数必须大于0,请输入正确的限笔数
SCORE_IS_ILLEGAL 芝麻分限额小于0不合法 芝麻分限额小于0不合法,请输入正确的芝麻分限额
INVALID_PARAMETER 参数有误,风控配置错误 风控配置错误,请根据错误信息更正风控配置参数
SMID_IS_NULL 间连模式创建信用服务未配置二级商户 间连模式创建信用服务未配置二级商户,请配置二级商户ID
ISV_NO_AUTH_CREATE 间连模式创建信用服务isv商户无权限操作此二级商户 间连模式创建信用服务isv商户无权限操作此二级商户,请检查isv商户和二级商户的所属关系是否正确
SMID_NOT_ALLOW 直连模式创建信用服务不可设置二级商户 直连模式创建信用服务不可设置二级商户,请删除二级商户ID配置
SUB_MERCHANT_QUERY_FAILURE 二级商户不能为空 二级商户不能为空,请检查商户ID输入是否正确
CREATE_TYPE_IS_ILLEGAL 信用服务创建类型不合法 信用服务创建类型不合法,请按照文档输入合法的创建类型
CREDIT_SERVICE_ALREADY_EXIST 信用服务已创建 信用服务已创建,请勿重复创建
MERCHANT_NOT_EXIST 商户信息不存在 商户信息不存在,请检查配置的商户ID是否存在
INVALID_PARAMETER 参数有误,参数为空 参数为空,请根据错误信息提示传入必传参数
onlineServer