第一步：创建应用

第二步：配置密钥

第三步：搭建和配置开发环境

1.下载服务端SDK

2.接口调用配置

AlipayClient alipayClient = new DefaultAlipayClient(URL, APP_ID, APP_PRIVATE_KEY, FORMAT, CHARSET, ALIPAY_PUBLIC_KEY, SIGN_TYPE);

关键参数说明:

第四步：接口调用

调用流程

1. 调用zhima.customer.ep.certification.initialize接口进行企业认证初始化，并获取返回值biz_no。biz_no是本次认证的标识，在后面的认证接口和查询接口会用到。
2. 跳转到zhima.customer.ep.certification.certify页面接口让用户完成认证，用户完成认证后会跳转回商户回调地址。必须在这个接口的请求中传入return_url才能回跳到商户，return_url支持多个协议，可以按照需要使用。接入方式和回调协议案例参考下面的demo。
3. 可以根据第一步返回的biz_no查询本次认证的状态和结果。

AlipayClient alipayClient =newDefaultAlipayClient("
https://openapi.alipay.com/gateway.do
","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
ZhimaCustomerEpCertificationInitializeRequest request =new ZhimaCustomerEpCertificationInitializeRequest();
request.setBizContent("{"+
"\"transaction_id\":\"ZGYD201610252323000001234\","+
"\"product_code\":\"w1010100003000001889\","+
"\"biz_code\":\"EP_ALIPAY_ACCOUNT\","+
"\"identity_param\":\"{\\\"identity_type\\\":\\\"EP_CERT_INFO\\\",\\\"cert_type\\\":\\\"IDENTITY_CARD\\\",\\\"cert_name\\\":\\\"收委\\\",\\\"cert_no\\\":\\\"260104197909275964\\\",\\\"ep_cert_type\\\":\\\"NATIONAL_LEGAL_MERGE\\\",\\\"ep_cert_name\\\":\\\"xxx有限公司\\\",\\\"ep_cert_no\\\":\\\"91330000327827106L\\\"}\","+
"\"merchant_config\":\"{\\\"xxx\\\":\\\"xxx\\\"}\","+
"\"ext_biz_param\":\"{}\""+
"  }");
ZhimaCustomerEpCertificationInitializeResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
}else{
System.out.println("调用失败");
}

// 获取alipay client
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", APP_ID, APP_PRIVATE_KEY, "json", CHARSET, ALIPAY_PUBLIC_KEY, "RSA2");
ZhimaCustomerEpCertificationCertifyRequest request = new ZhimaCustomerEpCertificationCertifyRequest();

// 设置业务参数,必须要biz_no
request.setBizContent("{\"biz_no\":\"ZM201611103000000888800000733621\"}");

// 设置回调地址,必填
request.setReturnUrl("https://www.taobao.com");

// 这里一定要使用GET模式
ZhimaCustomerEpCertificationCertifyResponse response = alipayClient.pageExecute(request, "GET");
// 从body中获取URL
String url = response.getBody();
System.out.println("generateCertifyUrl url:" + url);

https://openapi.alipay.com/gateway.do?alipay_sdk=alipay-sdk-java-dynamicVersionNo&app_id=2015111100758155&biz_content=%7B%22biz_no%22%3A%22ZM201611253000000121200404215172%22%7D&charset=GBK&format=json&method=zhima.customer.ep.certification.certify&return_url=http%3A%2F%2Fwww.taobao.com&sign=MhtfosO8AKbwctDgfGitzLvhbcvi%2FMv3iBES7fRnIXn%2BHcdwq9UWltTs6mEvjk2UoHdLoFrvcSJipiE3sL8kdJMd51t87vcwPCfk7BA5KPwa4%2B1IYzYaK6WwbqOoQB%2FqiJVfni602HiE%2BZAomW7WA3Tjhjy3D%2B9xrLFCipiroDQ%3D&sign_type=RSA2&timestamp=2017-09-07-25+15%3A00%3A59&version=1.0&sign=MhtfosO8AKbwctDgfGitzLvhbcvi%2FMv3iBES7fRnIXn%2BHcdwq9UWltTs6mEvjk2UoHdLoFrvcSJipiE3sL8kdJMd51t87vcwPCfk7BA5KPwa4%2B1IYzYaK6WwbqOoQB%2FqiJVfni602HiE%2BZAomW7WA3Tjhjy3D%2B9xrLFCipiroDQ%3D

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
ZhimaCustomerEpCertificationQueryRequest request = new ZhimaCustomerEpCertificationQueryRequest();
request.setBizContent("{" +
"\"biz_no\":\"ZM201612013000000393900404029253\"" +
"  }");
ZhimaCustomerEpCertificationQueryResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

关于沙箱

如何接入沙箱

企业认证沙箱接入注意点

FAQ