文档中心 > API类目 > 实人认证API

zoloz.authentication.customer.facemanage.delete (热脸出库)

出库逻辑

公共参数

请求地址:
环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do
公共请求参数:
参数 类型 是否必填 最大长度 描述 示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 zoloz.authentication.customer.facemanage.delete
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 - 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
facetype String 必须 20 入库类型 IDCARD或ALIPAY_USER
faceval String 必须 2000 入库用户信息 类型为IDCARD数据格式:[{"certName": "张三","certNo":"3101101999xxxxxxxx","certType":"IDCARD"}]类型ALIPAY_USER数据格式:[{"alipayUid":"20885022"}]
validtimes String 必须 50 有效期天数,如7天、30天、365天 7
devicenum String 必须 100 商户机具唯一编码,关键参数 商户机具唯一编码
storecode String 可选 50 门店编码 HZ1000435
brandcode String 可选 20 品牌 KFC
group String 可选 20 分组 group0
areacode String 可选 20 地域编码 010
bizscale String 可选 20 业务量 9999999999
extinfo String 可选 5000 拓展参数 {}

公共响应参数

参数 类型 是否必填 最大长度 描述 示例值
code String - 网关返回码,详见文档 40004
msg String - 网关返回码描述,详见文档 Business Failed
sub_code String - 业务返回码,详见文档 ACQ.TRADE_HAS_SUCCESS
sub_msg String - 业务返回码描述,详见文档 交易已被支付
sign String - 签名,详见文档 DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo=

响应参数

参数 类型 是否必填 最大长度 描述 示例值
retcode String 必填 30 返回码 OK_SUCCESS
retmessage String 必填 100 返回信息 成功
result String 必填 500 返回值 {}

请求示例

  • JAVA
  • .NET
  • PHP
  • HTTP请求源码
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
ZolozAuthenticationCustomerFacemanageDeleteRequest request = new ZolozAuthenticationCustomerFacemanageDeleteRequest();
request.setBizContent("{" +
"\"facetype\":\"IDCARD或ALIPAY_USER\"," +
"\"faceval\":\"类型为IDCARD数据格式:[{\\\"certName\\\": \\\"张三\\\",\\\"certNo\\\":\\\"3101101999xxxxxxxx\\\",\\\"certType\\\":\\\"IDCARD\\\"}]类型ALIPAY_USER数据格式:[{\\\"alipayUid\\\":\\\"20885022\\\"}]\"," +
"\"validtimes\":\"7\"," +
"\"devicenum\":\"商户机具唯一编码\"," +
"\"storecode\":\"HZ1000435\"," +
"\"brandcode\":\"KFC\"," +
"\"group\":\"group0\"," +
"\"areacode\":\"010\"," +
"\"bizscale\":\"9999999999\"," +
"\"extinfo\":\"{}\"" +
"  }");
ZolozAuthenticationCustomerFacemanageDeleteResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

  • JSON示例
{
	"zoloz_authentication_customer_facemanage_delete_response":{
		"msg":"Success",
		"result":"{}",
		"retmessage":"成功",
		"code":"10000",
		"retcode":"OK_SUCCESS"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

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

业务错误码

错误码 错误描述 解决方案
SYSTEM_ERROR 系统繁忙 检查网络是否正常
INVALID_PARAMETER 参数有误 请检查参数是否正常
BIZ_ERROR 业务异常 检查参数是否正常

公共错误码

返回
顶部