马蜂窝开放平台

同步签证办理人材料信息

此接口调用频次上限默认为30次/分钟，如不能满足业务需要请添加马蜂窝开放平台交流群：201650204 申请调整。

请求URL

正式环境：https://openapi.mafengwo.cn/deals/rest

请求Action

action：sales.visa.system.applicants.sync

请求参数

参数名称	参数类型	必填	示例	描述
order_id	string	是	2253329201801103938959	旅行商城业务订单号
applicant_info	array	是	[]	办理人信息
{}	object	是	0	办理人信息
└ visa_id	int	否	1234	办理人ID
└ id_card	string	否	110101200001019736	身份证号码
└ passport	string	否	123123123	护照证件号
└ laissez_passer_tw	string	否		台湾通行证
└ laissez_passer	string	否		港澳通行证
└ first_name_zh	string	是	三	名【中文】
└ last_name_zh	string	是	张	姓【中文】
└ last_name_en	string	是	ZHANG	姓【英文】
└ first_name_en	string	否	SANG	名【英文】
└ birthday	date	是	2000-12-12	出生日期
└ gender	int	是	1	性别 1是男 2是女
└ birthplace	string	否	中国北京市朝阳区	出生地址
└ passport_issue_date	date	是	2018-12-12	护照签发日期
└ passport_issue_addr	string	否	北京	护照签发地点
└ passport_type	int	是	1	护照类型 1是普通因私护照 2是外交护照 3是公务护照
└ nationality	string	是	MA MOROCCO	国家码
└ passport_issue_date_expired	date	是	2019-11-11	护照有效日期
└ passort_issue_organ	string	否	护照签证机构	护照签证机构
└ personal_photo_unique_keys	string	否	be09d81b6...	上传文件生成的唯一标识可以调用办签材料上传上传文件或者图片
└ passport_home_page_unique_keys	string	否	护照首页	护照首页
└ status	int	是	1	当前办理人签证办理所处的状态具体说明请见办签进度状态说明
└ delivery_addr	string	否	北京朝阳区	收件地址
└ visa_effective_date	date	否	2019-11-11	签证生效日期

响应参数

参数名称	参数类型	示例	描述
order_id	string	2253329201801103938959	旅行商城订单号

响应示例

{
    "order_id":"2253329201801103938959"
}

异常错误码

异常码	异常信息
10070012	渠道信息更新失败
10070011	渠道账号未授权
10070010	订单渠道不匹配
10070003	签证ID异常