1. 刷脸实名认证
畅想自动发卡平台开放平台
  • 一分钟接入畅想自动发卡开放平台
  • 支付接口
    • 创建订单
      POST
    • 支付结果通知
      POST
    • 查询订单状态
      POST
  • 下发备用金
    • 查询下发订单状态
      POST
    • 下发成功结果通知
      POST
    • 创建下发订单
      POST
  • 刷脸实名认证
    • 创建实名认证订单
      POST
    • 查询刷脸实名认证结果
      POST
  • 异步投诉通知
    • 异步投诉通知示例
      POST
  1. 刷脸实名认证

创建实名认证订单

POST
/api/face-recognition
创建实名认证接口

返回成功时 需要将url地址转成二维码供用户使用支付宝扫码认证

- cert_no 身份证号码
- cert_name 身份证姓名
- return_url  刷脸完成后跳转地址
- app_key  商户接口appkey 在商户api对接中获取
- app_secret 商户接口 app_secret 在商户api对接中获取
- sign 签名

签名生成方法:

php
示例
   $data = [
        'cert_no' => '1234567890',
        'cert_name' => 'John Doe ',
        'return_url' => 'https://xxxx',
        'app_key' => '1234567890',
        'app_secret' => '1234567890',
    ];
    $sign = $this->sign($data);

   // $params 中 包含 参数
   // cert_no,cert_name,return_url,app_key,app_secret
    
    public function sign($params): string
    {
        $params = array_filter($params);
        ksort($params);
        $string = '';
        foreach ($params as $key => $value) {
            if ($key != 'sign') {
                $string .= $key . '=' . $value . '&';
            }
        }
        $string = rtrim($string, '&');
        return strtolower(md5($string));
    }


请求成功

json
{
    "code": 1,
    "status" : 201,
    "msg": "创建成功",
    "data": {
        "url": "",  // 需要转成二维码 让用户使用支付宝扫
        "time": "2025-04-10 10:02:01",
        "face_key": "3d1ad322c92b41f6b0762f7f6edcf68b"
    }
}

{
    "code": 1,
    "status" : 200,
    "msg": "该用户已实名认证成功",
}

- code为0时  表示请求参数有错误
    - status为400x时 表示参数或者验证错误
- code为1时 表示请求成功  
    - status 200 表示该用户在该平台已经实名验证成功
    - status 201 表示该用户需要执行刷脸认证 data中的url 转成二维码供用户使用支付宝扫码认证

请求参数

Header 参数

Body 参数multipart/form-data

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/face-recognition' \
--header 'Accept: application/json' \
--form 'cert_no="-"' \
--form 'cert_name="-"' \
--form 'return_url="-"' \
--form 'app_key="-"' \
--form 'sign="-"'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 1,
    "msg": "创建成功",
    "status": 200,
    "data": {
        "url": "",
        "time": "2025-04-10 10:02:01",
        "face_key": ""
    }
}
🟢200错误
上一页
创建下发订单
下一页
查询刷脸实名认证结果
Built with