通用场景
安心付开通接口
公共请求参数
业务请求参数
merchant_name｜商户名称必选string[1,80]
【描述】商户名称
【示例值】xxx有限公司
pid｜商户id必选string[1,20]
【描述】商户id
【示例值】208884196184xxxx
card_types｜卡类型必选array[1,1]
【描述】卡类型。其中开通了先享次卡后才能在制卡时使用先享后付的资金模式。
【枚举值】
安心付周期卡: axf_merchant_period_pay
安心付周期卡间连版: axf_merchant_period_pay_indirect
先享次卡: axf_xian_xiang_times_card
【注意事项】单次开通只支持一个卡类型
【示例值】["axf_merchant_period_pay"]
price_infos｜价格关联key必选array
【描述】价格关联key
price_rate｜费率必选string[1,4]
【描述】费率，最多两位小数，范围为0.38～0.6，
周期卡间联版没有收费协议该字段可不填
【注意事项】周期卡间联版没有收费协议该字段可不填
【示例值】0.38
back_product_code｜后台产品可选string[1,99]
【描述】安心付直联版后台产品code使用商家扣款（i1140100001000001000）、
间联版不需要、
安心付先享次卡需要（i1140300001000013424和i1140100001000001000）
【枚举值】
商家扣款: i1140100001000001000
jsapi支付: i1140300001000013424
【注意事项】周期卡间联版没有收费协议该字段可不填
【示例值】i1140100001000001000
settle_in_merchant_license｜资质必选settleinmerchantlicense
【描述】资质
【注意事项】资质
name｜商户简称必选string[1,30]
【描述】商户简称。用于芝麻信用服务开通。
【示例值】xxx公司
phone｜凯发k8官方网娱乐官方的联系方式必选string[11,11]
【描述】凯发k8官方网娱乐官方的联系方式
【示例值】15911112222
mcc_code｜商户二级类目code可选string[1,10]
【描述】商户二级类目code
【示例值】b0064
common_merchant_licenses｜资质详情可选[0,20]
【描述】商户上传资质详情，若非必要不传，不传以商户在支付宝已有证件为准
license_type｜资质类型可选string[1,32]
【描述】用户上传资质类型
【枚举值】
营业执照: business_license
【示例值】business_license
license_name｜资质名称可选string[1,255]
【描述】资质名称。如营业执照就是营业执照的名称
【示例值】xx有限公司
code｜资质code可选string[1,18]
【描述】资质code，包括登记管理部门代码、机构类型代码、行政区划码、主体识别码和校验码
【示例值】91350602mxxxxxxxxx
effective_date｜资质有效期可选string[1,10]
【描述】资质有效期 {dateformat{yyyy-mm-dd}} 长期有效传入 9999-12-31
【示例值】2024-10-01
license_urls｜凭证图片链接可选array[0,16]
【描述】资质凭证图片链接,通过调用 ant.merchant.expand.indirect.image.upload(图片上传)接口返回的image_id作为参数
【示例值】["xxxxxxxxxxxx.jpg"]
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.commerce.merchantcard.open.create&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={
"merchant_name":"xxx有限公司",
"pid":"208884196184xxxx",
"card_types":[
"axf_merchant_period_pay"
],
"price_infos":[
{
"price_rate":"0.38",
"back_product_code":"i1140100001000001000"
}
],
"settle_in_merchant_license":{
"common_merchant_licenses":[
{
"license_name":"xx有限公司",
"code":"91350602mxxxxxxxxx",
"license_type":"business_license",
"effective_date":"2024-10-01",
"license_urls":[
"xxxxxxxxxxxx.jpg"
]
}
],
"phone":"15911112222",
"name":"xxx公司",
"mcc_code":"b0064"
}
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
submit_result｜开通是否成功必选boolean(10)
【描述】开通是否成功
【示例值】false
fail_reason｜提交失败的原因可选string(256)
【描述】提交失败的原因
【示例值】失败原因
mcc_code｜商户二级类目code可选string(10)
【描述】商户二级类目code
【示例值】b0139
mcc_name｜商户二级类目名称可选string(99)
【描述】商户二级类目名称
【示例值】宠物
响应示例
正常示例
异常示例
{
"alipay_commerce_merchantcard_open_create_response": {
"code": "10000",
"msg": "success",
"submit_result": false,
"fail_reason": "失败原因",
"mcc_code": "b0139",
"mcc_name": "宠物"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| cardtypes_null_check_error | 卡类型字段为空 | 需传卡类型字段 |
| price_infos_back_product_err | 间联周期卡开通不允许使用商家扣款（i1140100001000001000）后台产品 | 开通间联周期卡开通价格关联key里面的后台产品不要选择商家扣款（i1140100001000001000）后台产品 |
| solution_type_access_error | 存在开通的间联周期卡和直联周期卡，不能同时开通，两者只能开通一个 | 存在开通的间联周期卡和直联周期卡，不能同时开通，不需要再开周期卡 |