PDC
  1. 2.0
PDC
  • 上上签开发接口
    • 上上签开发接口
    • 1.0
      • 1.0
      • 商品列表查询
      • 商品详情查询
      • 创建订单
      • 订单支付
      • 提交申请人资料
      • 更新申请人资料
      • 查询订单详情
      • 订单补差价
      • 订单状态变更回调通知
      • 申请人赴馆时间更新
      • 查询国家使馆信息
      • 账单获取接口
      • 配置获取
      • 订单快递邮寄资料信息更新
      • 商品价格查询
      • 申请人发起重新审核
      • 订单回寄地址更新
      • 获取该商品最早可出行日期
      • 更新订单生效日期
    • 2.0
      • ReadMe
      • 2.0
      • 商品列表查询
        POST
      • 商品详情查询
        POST
      • 商品价格查询
        POST
      • 商品状态变更回调通知
        POST
      • 创建订单
        POST
      • 订单支付
        POST
      • 查询订单详情
        POST
      • 订单补差价
        POST
      • 上传文件
        POST
      • 申请人护照信息OCR识别
        POST
      • 申请人证件照制作
        POST
      • 查询申请人申请表url
        POST
      • 订单退款
        POST
      • 订单快递邮寄资料信息更新
        POST
      • 订单状态变更回调通知
        POST
      • 资料变更回调通知接口说明
        POST
      • 申请人赴馆时间更新
        POST
      • 查询国家使馆信息
        POST
      • 账单获取接口
        POST
      • 配置获取
        POST
      • 订单回寄地址更新
        POST
      • 申请人身份证信息OCR识别
        POST
      • 申请人资料提交(完全匹配)
        POST
      • 申请人资料重新提交
        POST
      • 申请人发起重新审核
        POST
      • 获取该商品最早可出行日期
        POST
      • 更新订单生效日期
        POST
  1. 2.0

申请人资料提交(完全匹配)

开发中
vgs_dev
https://dapi.visageniusglobal.com
vgs_dev
https://dapi.visageniusglobal.com
POST
/openvisa/applicant_material_submit

一、调用前提#

已调用order_pay接口支付订单

二、变更说明#

变更内容变更人变更时间
1.如果资料存在身份证OCR类型(pattern = 1)增加必传id_card结构陈杨2024-07-19
2.如果资料存在婚姻证明(pattern = 3)增加上送项marital_status(婚姻状态)陈杨2024-07-19

三、接口说明#

1、将申请人需要提交的电子资料提交到上上签,以下所有资料需要先通过上传文件接口获得temp_key后在进行上传。
2、证件照可以使用制作证件照,也可以直接上传原图
3、如果商品必填的电子资料(elec_material)有护照OCR类型(pattern=2),那必传passport(护照OCR信息)。如有身份证OCR类型(pattern=1)那必传id_card(身份证OCR信息)
4、如果有申请表(application),需要填写完申请表才能提交资料

四、鉴权#

见:商品列表查询

请求参数

Header 参数
X-Date
string 
可选
示例值:
{{gmt}}
X-Appid
string 
可选
示例值:
{{appid}}
Authorization
string 
可选
示例值:
{{sign}}
Body 参数application/json
order_id
integer 
订单id
必需
applicant_set
array [object {8}] 
必需
applicant_id
integer 
申请人id
必需
identity_id
enum<integer> 
身份id
必需
0在职人员 1自由职业者 2退休人员 3在校学生 4学龄前儿童 5通用身份
枚举值:
012345
applicant_name
string 
申请人姓名
必需
city_id
integer 
大使馆城市id
可选
与使馆查询接口中的city_id 一致
date_choice
integer 
提交赴馆时间的选择
可选
需要赴馆时必选,0手动选择时间 1近30天都可以 2近30天都不行
other_date
string 
其他时间
可选
选择近30天都不合适时, 其他的赴馆时间备注,100个字符以内
preferred_date
array [object {2}] 
选择的日期
可选
手动选择的希望赴馆的日期,限制为3个
material_set
object 
申请人资料
可选
示例
{
    "order_id": 61912630,
    "applicant_set": [
        {
            "applicant_id": -39993911,
            "identity_id": 0,
            "applicant_name": "dolore consequat",
            "city_id": 6804833,
            "date_choice": -12433121,
            "other_date": "voluptate consequat Duis",
            "preferred_date": [
                {
                    "date": "2025-03-13 19:33:55",
                    "period": 0
                },
                {
                    "date": "2024-12-15 12:37:43",
                    "period": 0
                },
                {
                    "date": "2025-08-29 04:25:30",
                    "period": 0
                }
            ],
            "material_set": {
                "elec_material": [
                    {
                        "material_id": 80774012,
                        "marital_status": 56942813,
                        "file_list": [
                            {
                                "file_id": "nulla mollit",
                                "temp_key": "dolore dolor qui"
                            }
                        ]
                    },
                    {
                        "material_id": 9192391,
                        "marital_status": 1027336,
                        "file_list": [
                            {
                                "file_id": "culpa enim proident",
                                "temp_key": "exercitation"
                            },
                            {
                                "file_id": "veniam nostrud in consectetur",
                                "temp_key": "labore cupidatat qui incididunt aute"
                            }
                        ]
                    },
                    {
                        "material_id": 99741771,
                        "marital_status": -49198953,
                        "file_list": [
                            {
                                "file_id": "qui",
                                "temp_key": "Duis Lorem ex"
                            },
                            {
                                "file_id": "pariatur aliqua adipisicing",
                                "temp_key": "cillum reprehenderit Ut"
                            },
                            {
                                "file_id": "eiusmod aliqua Duis",
                                "temp_key": "culpa in do"
                            }
                        ]
                    }
                ],
                "idphoto": {
                    "original_temp_key": "irure id est officia",
                    "temp_key": "Lorem voluptate"
                },
                "passport": {
                    "passport_number": "sint cillum",
                    "surname_cn": "折",
                    "surname_pinyin": "Anais",
                    "name_cn": "鹏涛",
                    "name_pinyin": "velit ex quis est",
                    "fullname": "qui culpa",
                    "gender": -39889857,
                    "birthday": "qui laborum enim sint",
                    "birth_place_cn": "pariatur ex in",
                    "birth_place_pinyin": "est ex ipsum",
                    "issue_place_cn": "sed consequat ut Ut",
                    "issue_place_pinyin": "est nulla cupidatat",
                    "issue_date": "proident incididunt et",
                    "expire_date": "in laborum",
                    "issue_authority_cn": "elit nulla exercitati",
                    "issue_authority_en": "officia",
                    "original": "Ut in veniam eu mollit",
                    "url": "voluptate velit et",
                    "file_id": "labore"
                },
                "id_card": {
                    "special_code": -58581162.30816868,
                    "id_no": "dolore enim aute esse",
                    "fullname": "sint cillum aute",
                    "gender": 62484432,
                    "nation": "elit aliquip",
                    "birthday": "2023-05-09",
                    "address": "sed ad",
                    "expire_date": "ut fugiat ea eu magna",
                    "issue_authority": "laborum",
                    "front_original": "sint",
                    "back_original": "dolor",
                    "front_url": "deserunt fugiat occaecat veniam",
                    "back_url": "sed exercitation",
                    "front_file_id": "Duis cupidatat",
                    "back_file_id": "Excepteur do dolore cillum"
                }
            }
        },
        {
            "applicant_id": -61246679,
            "identity_id": 5,
            "applicant_name": "in laborum",
            "city_id": -29878112,
            "date_choice": -2191879,
            "other_date": "consequat laboris",
            "preferred_date": [
                {
                    "date": "2025-01-05 17:57:22",
                    "period": 0
                },
                {
                    "date": "2025-04-28 01:49:53",
                    "period": 0
                }
            ],
            "material_set": {
                "elec_material": [
                    {
                        "material_id": 81732462,
                        "marital_status": -37416387,
                        "file_list": [
                            {
                                "file_id": "aliqua quis ullamco",
                                "temp_key": "ut"
                            }
                        ]
                    },
                    {
                        "material_id": -10004768,
                        "marital_status": 55389817,
                        "file_list": [
                            {
                                "file_id": "ut ut consectetur",
                                "temp_key": "dolor"
                            },
                            {
                                "file_id": "dolore id et incididunt nisi",
                                "temp_key": "non pariatur ea proident"
                            }
                        ]
                    },
                    {
                        "material_id": 16300364,
                        "marital_status": 32240466,
                        "file_list": [
                            {
                                "file_id": "quis",
                                "temp_key": "sed aliquip ut dolor do"
                            }
                        ]
                    }
                ],
                "idphoto": {
                    "original_temp_key": "cillum consectetur nulla qui",
                    "temp_key": "nisi ut"
                },
                "passport": {
                    "passport_number": "in",
                    "surname_cn": "皋",
                    "surname_pinyin": "Mckenzie",
                    "name_cn": "鑫鹏",
                    "name_pinyin": "minim ipsum esse",
                    "fullname": "sed dolo",
                    "gender": -54489617,
                    "birthday": "id",
                    "birth_place_cn": "do proident nostrud enim",
                    "birth_place_pinyin": "Duis",
                    "issue_place_cn": "sint Excepteur nulla voluptate ad",
                    "issue_place_pinyin": "ea sunt anim dolore eu",
                    "issue_date": "culpa est fugiat in",
                    "expire_date": "in anim",
                    "issue_authority_cn": "amet esse",
                    "issue_authority_en": "in quis amet",
                    "original": "quis",
                    "url": "dolore in",
                    "file_id": "anim consequat in in"
                },
                "id_card": {
                    "special_code": 65540979.9623687,
                    "id_no": "enim labore ex",
                    "fullname": "et enim culpa dolor",
                    "gender": 41443052,
                    "nation": "Excepteur",
                    "birthday": "2022-02-14",
                    "address": "est velit dolor veniam",
                    "expire_date": "enim in",
                    "issue_authority": "in exercitation quis",
                    "front_original": "id enim officia irure",
                    "back_original": "laboris adipisicing aliqua nulla deserunt",
                    "front_url": "ad eiusmod mollit labore consequat",
                    "back_url": "sed velit in",
                    "front_file_id": "eu elit laboris velit",
                    "back_file_id": "dolor Ut eiusmod sed laboris"
                }
            }
        },
        {
            "applicant_id": 80640426,
            "identity_id": 4,
            "applicant_name": "esse eiusmod",
            "city_id": -9764587,
            "date_choice": -34207549,
            "other_date": "in ipsum",
            "preferred_date": [
                {
                    "date": "2024-04-13 04:21:50",
                    "period": 0
                },
                {
                    "date": "2025-04-11 20:43:06",
                    "period": 0
                }
            ],
            "material_set": {
                "elec_material": [
                    {
                        "material_id": 51135573,
                        "marital_status": 95212325,
                        "file_list": [
                            {
                                "file_id": "sunt",
                                "temp_key": "Duis ipsum velit et"
                            }
                        ]
                    },
                    {
                        "material_id": 56052788,
                        "marital_status": -96426920,
                        "file_list": [
                            {
                                "file_id": "exercitation laboris",
                                "temp_key": "commodo non nostrud reprehenderit"
                            },
                            {
                                "file_id": "esse nostrud mollit",
                                "temp_key": "sint anim ut cupidatat"
                            }
                        ]
                    },
                    {
                        "material_id": 23405071,
                        "marital_status": 56173837,
                        "file_list": [
                            {
                                "file_id": "quis dolor non velit",
                                "temp_key": "irure do aliqua et"
                            },
                            {
                                "file_id": "cupidatat",
                                "temp_key": "sunt"
                            }
                        ]
                    }
                ],
                "idphoto": {
                    "original_temp_key": "sed nulla do ad ex",
                    "temp_key": "sint occaecat consequat minim do"
                },
                "passport": {
                    "passport_number": "reprehender",
                    "surname_cn": "类",
                    "surname_pinyin": "Kennith",
                    "name_cn": "烨华",
                    "name_pinyin": "sit dolor minim sunt esse",
                    "fullname": "Excepteur adipisicing ve",
                    "gender": 84295144,
                    "birthday": "Excepteur Lorem nisi",
                    "birth_place_cn": "ex non mollit",
                    "birth_place_pinyin": "magna",
                    "issue_place_cn": "nisi quis tempor",
                    "issue_place_pinyin": "laboris dolor fugiat",
                    "issue_date": "quis laborum sed dolor",
                    "expire_date": "est quis elit sint",
                    "issue_authority_cn": "incid",
                    "issue_authority_en": "aliqua elit ullamco",
                    "original": "voluptate pariatur proident sunt",
                    "url": "dolore dolor aliquip adipisicing Lorem",
                    "file_id": "et ut"
                },
                "id_card": {
                    "special_code": 15110626.08013165,
                    "id_no": "non deserunt nulla occaecat",
                    "fullname": "deserunt ad id",
                    "gender": 95471878,
                    "nation": "consequat laboris amet veniam laborum",
                    "birthday": "1991-08-17",
                    "address": "in consectetur",
                    "expire_date": "ipsum",
                    "issue_authority": "aliquip nisi anim",
                    "front_original": "commodo",
                    "back_original": "occaecat Excepteur ex Lorem laboris",
                    "front_url": "eu commodo aliquip esse culpa",
                    "back_url": "in",
                    "front_file_id": "sed ea dolor",
                    "back_file_id": "sed consectetur exercitation aliquip occaecat"
                }
            }
        }
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://dapi.visageniusglobal.com/openvisa/applicant_material_submit' \
--header 'X-Date: ' \
--header 'X-Appid: ' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_id": 61912630,
    "applicant_set": [
        {
            "applicant_id": -39993911,
            "identity_id": 0,
            "applicant_name": "dolore consequat",
            "city_id": 6804833,
            "date_choice": -12433121,
            "other_date": "voluptate consequat Duis",
            "preferred_date": [
                {
                    "date": "2025-03-13 19:33:55",
                    "period": 0
                },
                {
                    "date": "2024-12-15 12:37:43",
                    "period": 0
                },
                {
                    "date": "2025-08-29 04:25:30",
                    "period": 0
                }
            ],
            "material_set": {
                "elec_material": [
                    {
                        "material_id": 80774012,
                        "marital_status": 56942813,
                        "file_list": [
                            {
                                "file_id": "nulla mollit",
                                "temp_key": "dolore dolor qui"
                            }
                        ]
                    },
                    {
                        "material_id": 9192391,
                        "marital_status": 1027336,
                        "file_list": [
                            {
                                "file_id": "culpa enim proident",
                                "temp_key": "exercitation"
                            },
                            {
                                "file_id": "veniam nostrud in consectetur",
                                "temp_key": "labore cupidatat qui incididunt aute"
                            }
                        ]
                    },
                    {
                        "material_id": 99741771,
                        "marital_status": -49198953,
                        "file_list": [
                            {
                                "file_id": "qui",
                                "temp_key": "Duis Lorem ex"
                            },
                            {
                                "file_id": "pariatur aliqua adipisicing",
                                "temp_key": "cillum reprehenderit Ut"
                            },
                            {
                                "file_id": "eiusmod aliqua Duis",
                                "temp_key": "culpa in do"
                            }
                        ]
                    }
                ],
                "idphoto": {
                    "original_temp_key": "irure id est officia",
                    "temp_key": "Lorem voluptate"
                },
                "passport": {
                    "passport_number": "sint cillum",
                    "surname_cn": "折",
                    "surname_pinyin": "Anais",
                    "name_cn": "鹏涛",
                    "name_pinyin": "velit ex quis est",
                    "fullname": "qui culpa",
                    "gender": -39889857,
                    "birthday": "qui laborum enim sint",
                    "birth_place_cn": "pariatur ex in",
                    "birth_place_pinyin": "est ex ipsum",
                    "issue_place_cn": "sed consequat ut Ut",
                    "issue_place_pinyin": "est nulla cupidatat",
                    "issue_date": "proident incididunt et",
                    "expire_date": "in laborum",
                    "issue_authority_cn": "elit nulla exercitati",
                    "issue_authority_en": "officia",
                    "original": "Ut in veniam eu mollit",
                    "url": "voluptate velit et",
                    "file_id": "labore"
                },
                "id_card": {
                    "special_code": -58581162.30816868,
                    "id_no": "dolore enim aute esse",
                    "fullname": "sint cillum aute",
                    "gender": 62484432,
                    "nation": "elit aliquip",
                    "birthday": "2023-05-09",
                    "address": "sed ad",
                    "expire_date": "ut fugiat ea eu magna",
                    "issue_authority": "laborum",
                    "front_original": "sint",
                    "back_original": "dolor",
                    "front_url": "deserunt fugiat occaecat veniam",
                    "back_url": "sed exercitation",
                    "front_file_id": "Duis cupidatat",
                    "back_file_id": "Excepteur do dolore cillum"
                }
            }
        },
        {
            "applicant_id": -61246679,
            "identity_id": 5,
            "applicant_name": "in laborum",
            "city_id": -29878112,
            "date_choice": -2191879,
            "other_date": "consequat laboris",
            "preferred_date": [
                {
                    "date": "2025-01-05 17:57:22",
                    "period": 0
                },
                {
                    "date": "2025-04-28 01:49:53",
                    "period": 0
                }
            ],
            "material_set": {
                "elec_material": [
                    {
                        "material_id": 81732462,
                        "marital_status": -37416387,
                        "file_list": [
                            {
                                "file_id": "aliqua quis ullamco",
                                "temp_key": "ut"
                            }
                        ]
                    },
                    {
                        "material_id": -10004768,
                        "marital_status": 55389817,
                        "file_list": [
                            {
                                "file_id": "ut ut consectetur",
                                "temp_key": "dolor"
                            },
                            {
                                "file_id": "dolore id et incididunt nisi",
                                "temp_key": "non pariatur ea proident"
                            }
                        ]
                    },
                    {
                        "material_id": 16300364,
                        "marital_status": 32240466,
                        "file_list": [
                            {
                                "file_id": "quis",
                                "temp_key": "sed aliquip ut dolor do"
                            }
                        ]
                    }
                ],
                "idphoto": {
                    "original_temp_key": "cillum consectetur nulla qui",
                    "temp_key": "nisi ut"
                },
                "passport": {
                    "passport_number": "in",
                    "surname_cn": "皋",
                    "surname_pinyin": "Mckenzie",
                    "name_cn": "鑫鹏",
                    "name_pinyin": "minim ipsum esse",
                    "fullname": "sed dolo",
                    "gender": -54489617,
                    "birthday": "id",
                    "birth_place_cn": "do proident nostrud enim",
                    "birth_place_pinyin": "Duis",
                    "issue_place_cn": "sint Excepteur nulla voluptate ad",
                    "issue_place_pinyin": "ea sunt anim dolore eu",
                    "issue_date": "culpa est fugiat in",
                    "expire_date": "in anim",
                    "issue_authority_cn": "amet esse",
                    "issue_authority_en": "in quis amet",
                    "original": "quis",
                    "url": "dolore in",
                    "file_id": "anim consequat in in"
                },
                "id_card": {
                    "special_code": 65540979.9623687,
                    "id_no": "enim labore ex",
                    "fullname": "et enim culpa dolor",
                    "gender": 41443052,
                    "nation": "Excepteur",
                    "birthday": "2022-02-14",
                    "address": "est velit dolor veniam",
                    "expire_date": "enim in",
                    "issue_authority": "in exercitation quis",
                    "front_original": "id enim officia irure",
                    "back_original": "laboris adipisicing aliqua nulla deserunt",
                    "front_url": "ad eiusmod mollit labore consequat",
                    "back_url": "sed velit in",
                    "front_file_id": "eu elit laboris velit",
                    "back_file_id": "dolor Ut eiusmod sed laboris"
                }
            }
        },
        {
            "applicant_id": 80640426,
            "identity_id": 4,
            "applicant_name": "esse eiusmod",
            "city_id": -9764587,
            "date_choice": -34207549,
            "other_date": "in ipsum",
            "preferred_date": [
                {
                    "date": "2024-04-13 04:21:50",
                    "period": 0
                },
                {
                    "date": "2025-04-11 20:43:06",
                    "period": 0
                }
            ],
            "material_set": {
                "elec_material": [
                    {
                        "material_id": 51135573,
                        "marital_status": 95212325,
                        "file_list": [
                            {
                                "file_id": "sunt",
                                "temp_key": "Duis ipsum velit et"
                            }
                        ]
                    },
                    {
                        "material_id": 56052788,
                        "marital_status": -96426920,
                        "file_list": [
                            {
                                "file_id": "exercitation laboris",
                                "temp_key": "commodo non nostrud reprehenderit"
                            },
                            {
                                "file_id": "esse nostrud mollit",
                                "temp_key": "sint anim ut cupidatat"
                            }
                        ]
                    },
                    {
                        "material_id": 23405071,
                        "marital_status": 56173837,
                        "file_list": [
                            {
                                "file_id": "quis dolor non velit",
                                "temp_key": "irure do aliqua et"
                            },
                            {
                                "file_id": "cupidatat",
                                "temp_key": "sunt"
                            }
                        ]
                    }
                ],
                "idphoto": {
                    "original_temp_key": "sed nulla do ad ex",
                    "temp_key": "sint occaecat consequat minim do"
                },
                "passport": {
                    "passport_number": "reprehender",
                    "surname_cn": "类",
                    "surname_pinyin": "Kennith",
                    "name_cn": "烨华",
                    "name_pinyin": "sit dolor minim sunt esse",
                    "fullname": "Excepteur adipisicing ve",
                    "gender": 84295144,
                    "birthday": "Excepteur Lorem nisi",
                    "birth_place_cn": "ex non mollit",
                    "birth_place_pinyin": "magna",
                    "issue_place_cn": "nisi quis tempor",
                    "issue_place_pinyin": "laboris dolor fugiat",
                    "issue_date": "quis laborum sed dolor",
                    "expire_date": "est quis elit sint",
                    "issue_authority_cn": "incid",
                    "issue_authority_en": "aliqua elit ullamco",
                    "original": "voluptate pariatur proident sunt",
                    "url": "dolore dolor aliquip adipisicing Lorem",
                    "file_id": "et ut"
                },
                "id_card": {
                    "special_code": 15110626.08013165,
                    "id_no": "non deserunt nulla occaecat",
                    "fullname": "deserunt ad id",
                    "gender": 95471878,
                    "nation": "consequat laboris amet veniam laborum",
                    "birthday": "1991-08-17",
                    "address": "in consectetur",
                    "expire_date": "ipsum",
                    "issue_authority": "aliquip nisi anim",
                    "front_original": "commodo",
                    "back_original": "occaecat Excepteur ex Lorem laboris",
                    "front_url": "eu commodo aliquip esse culpa",
                    "back_url": "in",
                    "front_file_id": "sed ea dolor",
                    "back_file_id": "sed consectetur exercitation aliquip occaecat"
                }
            }
        }
    ]
}'

返回响应

🟢200成功
application/json
Body
ret
integer 
必需
msg
string 
必需
body
object 
必需
示例
{
    "ret":0,
    "msg":"",
    "body":{
        
    }
}
🟢200接口异常
🟠400参数不正确
🔴503服务异常
上一页
申请人身份证信息OCR识别
下一页
申请人资料重新提交
Built with