通用场景
商家调用芝麻企业受理信用服务的初始化入口
公共请求参数
业务请求参数
scene_code|场景码必选string[0,64]
【描述】受理场景码,由蚂蚁企业信用方分发提供,配置有误会返回参数错误
【示例值】ep_lg_h
device_type|商家设备类型必选string[0,32]
【描述】平台访问指定的设备类型,不填则前端根据用户实际设备类型自动加载
【枚举值】
移动设备: mobile
pc设备: pc
【示例值】pc
out_biz_no|商户唯一业务流水号可选string[0,64]
【描述】商户唯一业务流水号,由大小写字母和数字构成。
【示例值】test201805301527674106562f0000954216
ep_cert_no|企业统一社会信用代码可选string[0,32]
【描述】统一社会信用代码或营业执照注册号
【注意事项】商户若指定企业受理,要求同时传入企业统一社会信用代码和企业名称
【示例值】91330000327827106l
ep_name|企业名称可选string[0,128]
【描述】企业全称
【示例值】芝麻信用管理有限公司
merchant_return_url|商户指定回跳地址可选string[0,512]
【描述】使用蚂蚁企业信用相关服务后,回跳到该商户指定的地址
【示例值】https://mobile.alipay.com/index.htm?cid=wap_dc
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=zhima.credit.ep.acceptance.initialize&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"out_biz_no":"test201805301527674106562f0000954216",
"scene_code":"ep_lg_h",
"ep_cert_no":"91330000327827106l",
"ep_name":"芝麻信用管理有限公司",
"merchant_return_url":"https://mobile.alipay.com/index.htm?cid=wap_dc",
"device_type":"pc"
}'
说明:本示例仅供参考。
公共响应参数
业务响应参数
biz_no|受理单号必选string(64)
【描述】一次受理的唯一标识
【示例值】6aceb84769af4c94be36b77ea5988baa
access_token|芝麻企业信用数据访问令牌必选string(256)
【描述】芝麻企业信用数据访问令牌
【示例值】mtayodu.cd94aq.-gxkr4fqr2xwbvb1nqmvrhkumaw
out_biz_no|商户唯一的业务流水号可选string(64)
【描述】商户唯一业务流水号,由大小写字母和数字构成(当商户传入时返回)
【示例值】test201805301527674106562f0000954216
access_url可选string(2056)
【描述】用户接入企业信用受理台服务h5页面地址
(根据平台的具体应用场景决策返回,目前是实力标产品并且入参指定企业时)
【示例值】https://xxx?xxxxxxx
响应示例
正常示例
异常示例
{
"zhima_credit_ep_acceptance_initialize_response": {
"code": "10000",
"msg": "success",
"out_biz_no": "test201805301527674106562f0000954216",
"biz_no": "6aceb84769af4c94be36b77ea5988baa",
"access_token": "mtayodu.cd94aq.-gxkr4fqr2xwbvb1nqmvrhkumaw",
"access_url": "https://xxx?xxxxxxx"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息,修改参数后进行重试 |
limit_exceed | 服务调用量超出限制 | 接口请求速率超限,需调整调用量级 |
merchant_config_content_error | 商户场景配置内容错误 | 请根据返回的具体错误信息,到接入配置页面或联系支付宝凯发app官方网站的技术支持找到scenecode对应的具体配置,修改成正确的配置信息后再发起调用 |
no_arrangement | 商户未签约该产品 | 请完成签约后再发起请求 |