支付宝实名认证

通过支付宝比对用户姓名与身份证号是否一致，支持手机号、登录账号可选验证。此接口需要用户跳转支付宝授权，分为两步：先发起认证获取授权链接，再凭授权码查询结果。买断制，购买后按授权范围长期使用。

接口信息

项目	说明
接口地址	`POST /api/v3/alipaysm`
计费方式	买断制

调用流程

调用 action=start，录入用户信息，拿到 auth_url 授权链接

引导用户在浏览器打开 auth_url，完成支付宝授权

支付宝回调时携带授权码，或用户回到您的页面后，用授权码调用 action=result 查询认证结果

请求参数（action=start）

参数	类型	必填	说明
`action`	string	是	固定值 `start`
`user_name`	string	是	真实姓名
`cert_no`	string	是	身份证号
`mobile`	string	否	支付宝绑定手机号
`logon_id`	string	否	支付宝登录账号

请求参数（action=result）

参数	类型	必填	说明
`action`	string	是	固定值 `result`
`auth_code`	string	是	用户授权后获取的授权码

请求示例

PHP

<?php
$app_id = 'YOUR_APP_ID';
$app_key = 'YOUR_APP_KEY';
$base = 'https://yunsapi.com/api/v3/alipaysm';

// 第一步：发起认证
$params = [
    'action'    => 'start',
    'user_name' => '张三',
    'cert_no'   => '110101198806052133',
];

$ch = curl_init($base);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'X-APP-ID: ' . $app_id,
    'X-APP-KEY: ' . $app_key,
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

$resp = curl_exec($ch);
curl_close($ch);
echo $resp;

// 第二步：用户授权后，用授权码查询结果
$params2 = [
    'action'    => 'result',
    'auth_code' => 'USER_AUTH_CODE',
];
// 使用同样的方式 POST $params2，代码略

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class AlipayDemo {
    static final String APP_ID = "YOUR_APP_ID";
    static final String APP_KEY = "YOUR_APP_KEY";
    static final String URL = "https://yunsapi.com/api/v3/alipaysm";

    public static void main(String[] args) throws Exception {
        // 第一步：发起认证
        String body = "{\"action\":\"start\",\"user_name\":\"张三\",\"cert_no\":\"110101198806052133\"}";
        String resp = post(body);
        System.out.println(resp);

        // 第二步：用户授权后，用授权码查询结果
        // String body2 = "{\"action\":\"result\",\"auth_code\":\"USER_AUTH_CODE\"}";
        // System.out.println(post(body2));
    }

    static String post(String body) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest req = HttpRequest.newBuilder()
                .uri(URI.create(URL))
                .header("Content-Type", "application/json")
                .header("X-APP-ID", APP_ID)
                .header("X-APP-KEY", APP_KEY)
                .POST(HttpRequest.BodyPublishers.ofString(body))
                .build();
        HttpResponse<String> resp = client.send(req, HttpResponse.BodyHandlers.ofString());
        return resp.body();
    }
}

响应示例（start）

{
    "code": 0,
    "msg": "发起成功",
    "data": {
        "token": "a1b2c3d4e5f67890",
        "verify_id": "671ffcda5447bc87e9ed2f669eb143d4",
        "auth_url": "https://openauth.alipay.com/oauth2/publicAppAuthorize.htm?app_id=xxx&scope=id_verify"
    },
    "request_id": "req_xxx"
}

响应示例（result）

{
    "code": 0,
    "msg": "success",
    "data": {
        "verify": "1",
        "user_name": "张三",
        "cert_no": "110101198806052133"
    },
    "request_id": "req_xxx"
}

响应参数

参数	类型	说明
`data.token`	string	本次认证令牌（start 返回）
`data.verify_id`	string	认证记录 ID，可用于对账（start 返回）
`data.auth_url`	string	支付宝授权链接，引导用户打开（start 返回）
`data.verify`	string	认证结果，`1` 一致，`0` 不一致（result 返回）
`data.user_name`	string	核验姓名（result 返回）
`data.cert_no`	string	核验身份证号（result 返回）

说明：授权链接有时效，发起后请尽快引导用户完成授权；认证失败时接口返回业务错误码 1200 / 1201。