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
/visa/order_callback
时间变更内容
2023-11-17增加material_change字段,当资料不合格或者我方于后台更新资料时用于告知资料变更情况
2024-07-03申请人预约成功后,embassy_appointment增加了embassy_address(使馆地址)
2024-11-06预审不合格资料在material_set中返回,返回字段和内容和订单详情(order_query)中的material_set保持一致

请求参数

Body 参数application/json
notice_type_id
integer 
推送类型
必需
0:订单状态变更 1:申请人状态变更
notice_content
object 
推送内容
必需
order_id
integer 
订单id
必需
order_status
integer 
订单状态
必需
0,已取消 1,待上传资料 2,待填写申请表 3,待支付 4,待邮寄资料 5,办理中 6,已发货 7,待评价 8,已完成 9,已删除 10,待选择赴馆日期
pay_status
integer 
支付状态
必需
need_diff_price
integer 
是否需要补差价
必需
0否 1是
diff_price_set
object 
补差价。need_diff_price为1时必传
必需
return_express
array [object {3}] 
回寄快递信息
可选
applicant_set
array [object {7}] 
必需
refund_info
array [object {5}] 
退款信息
必需
不管notice_type_id等于几,都应该检查该对象里是否有数据
notice_desc
string 
推送描述
必需
示例
{
    "notice_type_id": -32630216,
    "notice_content": {
        "order_id": 23750284,
        "order_status": 70107484,
        "pay_status": 64288583,
        "need_diff_price": -15721193,
        "diff_price_set": {
            "diff_price": -60116167,
            "reason": "sunt dolore voluptate"
        },
        "applicant_set": [
            {
                "applicant_status": 13,
                "operate_desc": "fugiat",
                "applicant_no": "anim",
                "visa_result_url": [
                    "aliqua culpa dolor",
                    "nisi incididunt"
                ],
                "embassy_appointment": {
                    "embassy": "Lorem",
                    "appointmant_time": "pariatur ut",
                    "take_along_material": {
                        "user_provided": [
                            {
                                "material_id": "ea in dolor enim aute",
                                "template": "voluptate id velit sint",
                                "material_name": "anim officia commodo ex do",
                                "sample": "pariatur deserunt in labore Excepteur",
                                "attention": "sunt cillum dolor"
                            }
                        ],
                        "express_material": [
                            {
                                "material_name": "voluptate nostrud ad ullamco",
                                "sample": "ex",
                                "template": "et labore Duis ad ex",
                                "attention": "esse sed",
                                "material_id": "occaecat officia nisi minim"
                            }
                        ],
                        "other_material": [
                            {
                                "material_name": "adipisicing",
                                "material_url": "eu reprehenderit tempor"
                            },
                            {
                                "material_name": "labore Duis",
                                "material_url": "deserunt aliquip eu"
                            },
                            {
                                "material_url": "in est",
                                "material_name": "aliquip"
                            },
                            {
                                "material_name": "Excepteur Lorem dolor est irure",
                                "material_url": "veniam esse dolor eiusmod"
                            }
                        ]
                    }
                },
                "material_set": {
                    "application": {
                        "status": 3,
                        "memo": "申请表填写不完整"
                    },
                    "paper_material": [
                        {
                            "material_name": "邮寄资料-test-01",
                            "id": 102011,
                            "memo": "邮寄资料-预审未通过",
                            "status": 4,
                            "material_id": 11184
                        }
                    ],
                    "idphoto": {
                        "status": 3,
                        "memo": "证件照预审不通过,模糊"
                    },
                    "elec_material": [
                        {
                            "memo": "护照首页,太模糊",
                            "material_name": "护照首页",
                            "status": 3,
                            "material_id": 10000
                        },
                        {
                            "material_name": "身份证",
                            "material_id": 10002,
                            "status": 3,
                            "memo": "身份证-正面,太模糊,请重新上传",
                            "file_id_list": [
                                {
                                    "file_id": "chenyang-test-001",
                                    "status": 3,
                                    "memo": "身份证-正面,太模糊,请重新上传"
                                },
                                {
                                    "file_id": "chenyang-test-002",
                                    "status": 3,
                                    "memo": "身份证-反面,已过期,请拍摄最新的身份证"
                                }
                            ]
                        }
                    ]
                },
                "applicant_id": 49975578
            },
            {
                "applicant_status": 14,
                "operate_desc": "ut elit ipsum occaecat",
                "applicant_id": -77425186,
                "embassy_appointment": {
                    "embassy": "nulla in Excepteur incididunt",
                    "appointmant_time": "ut quis",
                    "take_along_material": {
                        "user_provided": [
                            {
                                "sample": "in sunt adipisicing tempor",
                                "material_name": "quis veniam",
                                "attention": "nostrud sed",
                                "template": "enim mollit dolor",
                                "material_id": "esse"
                            },
                            {
                                "attention": "cupidatat enim sint eiusmod Lorem",
                                "template": "minim ullamco dolore ipsum Lorem",
                                "material_id": "officia exercitation consequat",
                                "sample": "exercitation",
                                "material_name": "minim"
                            },
                            {
                                "material_id": "ut dolore",
                                "template": "dolore aute enim",
                                "attention": "veniam non incididunt",
                                "material_name": "cillum laboris dolore ut",
                                "sample": "Lorem dolore"
                            },
                            {
                                "attention": "dolor",
                                "template": "Lorem do labore",
                                "material_id": "exercitation eiusmod",
                                "sample": "sed",
                                "material_name": "incididunt officia"
                            },
                            {
                                "sample": "velit occaecat elit nostrud irure",
                                "material_name": "est exercitation",
                                "template": "ut voluptate dolor",
                                "material_id": "sed",
                                "attention": "ex"
                            }
                        ],
                        "express_material": [
                            {
                                "sample": "veniam aute Excepteur aliquip",
                                "attention": "in",
                                "template": "deserunt in non ut",
                                "material_id": "quis consequat aliqua ex",
                                "material_name": "deserunt"
                            },
                            {
                                "material_name": "deserunt aliquip",
                                "attention": "deserunt",
                                "sample": "consequat",
                                "material_id": "dolore",
                                "template": "ut do elit"
                            },
                            {
                                "material_name": "laboris id",
                                "sample": "eiusmod",
                                "material_id": "nostrud sed velit elit dolor",
                                "attention": "ex consectetur proident labore",
                                "template": "in elit laboris"
                            }
                        ],
                        "other_material": [
                            {
                                "material_name": "dolore commodo aute voluptate laboris",
                                "material_url": "ex anim ullamco velit"
                            },
                            {
                                "material_name": "in in",
                                "material_url": "ad deserunt aliquip Lorem ex"
                            },
                            {
                                "material_name": "et aliqua",
                                "material_url": "proident exercitation"
                            },
                            {
                                "material_name": "aliqua in dolore Lorem",
                                "material_url": "officia cillum culpa"
                            },
                            {
                                "material_name": "deserunt mollit aute in occaecat",
                                "material_url": "labore ut"
                            }
                        ]
                    }
                },
                "visa_result_url": [
                    "proident",
                    "aliqua sed",
                    "nulla Lorem",
                    "qui cillum ad dolor ea"
                ],
                "material_set": {
                    "paper_material": [],
                    "elec_material": []
                },
                "applicant_no": "aliquip Duis in non"
            },
            {
                "applicant_status": 10,
                "operate_desc": "laboris Lorem eiusmod",
                "material_set": {
                    "paper_material": [],
                    "elec_material": []
                },
                "embassy_appointment": {
                    "embassy": "anim consequat ut aliquip",
                    "appointmant_time": "dolore non labore nulla",
                    "take_along_material": {
                        "user_provided": [
                            {
                                "material_id": "ipsum consectetur velit commodo",
                                "attention": "et cillum consectetur ipsum",
                                "material_name": "dolor in Lorem",
                                "template": "et",
                                "sample": "ut ex minim anim"
                            },
                            {
                                "material_name": "irure qui minim anim dolor",
                                "attention": "anim dolore",
                                "sample": "pariatur non",
                                "template": "dolor ipsum in esse",
                                "material_id": "ut"
                            },
                            {
                                "material_id": "quis cillum pariatur",
                                "template": "amet",
                                "sample": "nisi quis incididunt occaecat culpa",
                                "attention": "incididunt tempor",
                                "material_name": "pariatur consequat anim"
                            },
                            {
                                "template": "eiusmod",
                                "attention": "proident Lorem ut eu",
                                "sample": "id non",
                                "material_id": "laborum voluptate",
                                "material_name": "esse"
                            }
                        ],
                        "express_material": [
                            {
                                "template": "ea in",
                                "attention": "irure ipsum officia adipisicing",
                                "sample": "eu dolore quis ut sed",
                                "material_name": "exercitation",
                                "material_id": "do Duis"
                            }
                        ],
                        "other_material": [
                            {
                                "material_name": "anim mollit Duis labore",
                                "material_url": "non ullamco laborum amet"
                            },
                            {
                                "material_url": "enim exercitation dolore",
                                "material_name": "Ut proident ad sint"
                            }
                        ]
                    }
                },
                "applicant_no": "ut",
                "visa_result_url": [
                    "elit nulla tempor incididunt qui",
                    "in culpa ut",
                    "in culpa fugiat quis veniam"
                ],
                "applicant_id": -65065596
            },
            {
                "applicant_status": 17,
                "operate_desc": "nulla qui officia Duis",
                "material_set": {
                    "paper_material": [],
                    "elec_material": []
                },
                "visa_result_url": [
                    "ipsum commodo non esse"
                ],
                "applicant_id": 85930101,
                "applicant_no": "dolore mollit",
                "embassy_appointment": {
                    "embassy": "voluptate consequat officia",
                    "appointmant_time": "eu minim amet",
                    "take_along_material": {
                        "user_provided": [
                            {
                                "material_id": "voluptate elit sunt ea",
                                "template": "exercitation",
                                "attention": "minim voluptate dolore sunt amet",
                                "material_name": "sint nostrud adipisicing esse laborum",
                                "sample": "commodo"
                            }
                        ],
                        "express_material": [
                            {
                                "material_name": "velit id",
                                "template": "Lorem minim ipsum in",
                                "sample": "veniam do",
                                "attention": "et ex",
                                "material_id": "mollit labore esse ullamco"
                            },
                            {
                                "attention": "minim et magna aliquip cupidatat",
                                "material_id": "mollit sint labore consectetur dolor",
                                "sample": "irure Lorem",
                                "template": "anim commodo minim",
                                "material_name": "esse amet sint Ut ea"
                            }
                        ],
                        "other_material": [
                            {
                                "material_url": "labore consectetur sed",
                                "material_name": "ullamco occaecat tempor"
                            },
                            {
                                "material_name": "adipisicing sed aliqua magna est",
                                "material_url": "in aliqua sed"
                            },
                            {
                                "material_url": "minim",
                                "material_name": "dolore"
                            }
                        ]
                    }
                }
            }
        ],
        "return_express": [
            {
                "tracking_num": "anim nisi non",
                "express_name": "deserunt nulla",
                "goods_type_id": -65448846
            }
        ]
    },
    "notice_desc": "esse elit"
}

示例代码

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/visa/order_callback' \
--header 'Content-Type: application/json' \
--data-raw '{
    "notice_type_id": -32630216,
    "notice_content": {
        "order_id": 23750284,
        "order_status": 70107484,
        "pay_status": 64288583,
        "need_diff_price": -15721193,
        "diff_price_set": {
            "diff_price": -60116167,
            "reason": "sunt dolore voluptate"
        },
        "applicant_set": [
            {
                "applicant_status": 13,
                "operate_desc": "fugiat",
                "applicant_no": "anim",
                "visa_result_url": [
                    "aliqua culpa dolor",
                    "nisi incididunt"
                ],
                "embassy_appointment": {
                    "embassy": "Lorem",
                    "appointmant_time": "pariatur ut",
                    "take_along_material": {
                        "user_provided": [
                            {
                                "material_id": "ea in dolor enim aute",
                                "template": "voluptate id velit sint",
                                "material_name": "anim officia commodo ex do",
                                "sample": "pariatur deserunt in labore Excepteur",
                                "attention": "sunt cillum dolor"
                            }
                        ],
                        "express_material": [
                            {
                                "material_name": "voluptate nostrud ad ullamco",
                                "sample": "ex",
                                "template": "et labore Duis ad ex",
                                "attention": "esse sed",
                                "material_id": "occaecat officia nisi minim"
                            }
                        ],
                        "other_material": [
                            {
                                "material_name": "adipisicing",
                                "material_url": "eu reprehenderit tempor"
                            },
                            {
                                "material_name": "labore Duis",
                                "material_url": "deserunt aliquip eu"
                            },
                            {
                                "material_url": "in est",
                                "material_name": "aliquip"
                            },
                            {
                                "material_name": "Excepteur Lorem dolor est irure",
                                "material_url": "veniam esse dolor eiusmod"
                            }
                        ]
                    }
                },
                "material_set": {
                    "application": {
                        "status": 3,
                        "memo": "申请表填写不完整"
                    },
                    "paper_material": [
                        {
                            "material_name": "邮寄资料-test-01",
                            "id": 102011,
                            "memo": "邮寄资料-预审未通过",
                            "status": 4,
                            "material_id": 11184
                        }
                    ],
                    "idphoto": {
                        "status": 3,
                        "memo": "证件照预审不通过,模糊"
                    },
                    "elec_material": [
                        {
                            "memo": "护照首页,太模糊",
                            "material_name": "护照首页",
                            "status": 3,
                            "material_id": 10000
                        },
                        {
                            "material_name": "身份证",
                            "material_id": 10002,
                            "status": 3,
                            "memo": "身份证-正面,太模糊,请重新上传",
                            "file_id_list": [
                                {
                                    "file_id": "chenyang-test-001",
                                    "status": 3,
                                    "memo": "身份证-正面,太模糊,请重新上传"
                                },
                                {
                                    "file_id": "chenyang-test-002",
                                    "status": 3,
                                    "memo": "身份证-反面,已过期,请拍摄最新的身份证"
                                }
                            ]
                        }
                    ]
                },
                "applicant_id": 49975578
            },
            {
                "applicant_status": 14,
                "operate_desc": "ut elit ipsum occaecat",
                "applicant_id": -77425186,
                "embassy_appointment": {
                    "embassy": "nulla in Excepteur incididunt",
                    "appointmant_time": "ut quis",
                    "take_along_material": {
                        "user_provided": [
                            {
                                "sample": "in sunt adipisicing tempor",
                                "material_name": "quis veniam",
                                "attention": "nostrud sed",
                                "template": "enim mollit dolor",
                                "material_id": "esse"
                            },
                            {
                                "attention": "cupidatat enim sint eiusmod Lorem",
                                "template": "minim ullamco dolore ipsum Lorem",
                                "material_id": "officia exercitation consequat",
                                "sample": "exercitation",
                                "material_name": "minim"
                            },
                            {
                                "material_id": "ut dolore",
                                "template": "dolore aute enim",
                                "attention": "veniam non incididunt",
                                "material_name": "cillum laboris dolore ut",
                                "sample": "Lorem dolore"
                            },
                            {
                                "attention": "dolor",
                                "template": "Lorem do labore",
                                "material_id": "exercitation eiusmod",
                                "sample": "sed",
                                "material_name": "incididunt officia"
                            },
                            {
                                "sample": "velit occaecat elit nostrud irure",
                                "material_name": "est exercitation",
                                "template": "ut voluptate dolor",
                                "material_id": "sed",
                                "attention": "ex"
                            }
                        ],
                        "express_material": [
                            {
                                "sample": "veniam aute Excepteur aliquip",
                                "attention": "in",
                                "template": "deserunt in non ut",
                                "material_id": "quis consequat aliqua ex",
                                "material_name": "deserunt"
                            },
                            {
                                "material_name": "deserunt aliquip",
                                "attention": "deserunt",
                                "sample": "consequat",
                                "material_id": "dolore",
                                "template": "ut do elit"
                            },
                            {
                                "material_name": "laboris id",
                                "sample": "eiusmod",
                                "material_id": "nostrud sed velit elit dolor",
                                "attention": "ex consectetur proident labore",
                                "template": "in elit laboris"
                            }
                        ],
                        "other_material": [
                            {
                                "material_name": "dolore commodo aute voluptate laboris",
                                "material_url": "ex anim ullamco velit"
                            },
                            {
                                "material_name": "in in",
                                "material_url": "ad deserunt aliquip Lorem ex"
                            },
                            {
                                "material_name": "et aliqua",
                                "material_url": "proident exercitation"
                            },
                            {
                                "material_name": "aliqua in dolore Lorem",
                                "material_url": "officia cillum culpa"
                            },
                            {
                                "material_name": "deserunt mollit aute in occaecat",
                                "material_url": "labore ut"
                            }
                        ]
                    }
                },
                "visa_result_url": [
                    "proident",
                    "aliqua sed",
                    "nulla Lorem",
                    "qui cillum ad dolor ea"
                ],
                "material_set": {
                    "paper_material": [],
                    "elec_material": []
                },
                "applicant_no": "aliquip Duis in non"
            },
            {
                "applicant_status": 10,
                "operate_desc": "laboris Lorem eiusmod",
                "material_set": {
                    "paper_material": [],
                    "elec_material": []
                },
                "embassy_appointment": {
                    "embassy": "anim consequat ut aliquip",
                    "appointmant_time": "dolore non labore nulla",
                    "take_along_material": {
                        "user_provided": [
                            {
                                "material_id": "ipsum consectetur velit commodo",
                                "attention": "et cillum consectetur ipsum",
                                "material_name": "dolor in Lorem",
                                "template": "et",
                                "sample": "ut ex minim anim"
                            },
                            {
                                "material_name": "irure qui minim anim dolor",
                                "attention": "anim dolore",
                                "sample": "pariatur non",
                                "template": "dolor ipsum in esse",
                                "material_id": "ut"
                            },
                            {
                                "material_id": "quis cillum pariatur",
                                "template": "amet",
                                "sample": "nisi quis incididunt occaecat culpa",
                                "attention": "incididunt tempor",
                                "material_name": "pariatur consequat anim"
                            },
                            {
                                "template": "eiusmod",
                                "attention": "proident Lorem ut eu",
                                "sample": "id non",
                                "material_id": "laborum voluptate",
                                "material_name": "esse"
                            }
                        ],
                        "express_material": [
                            {
                                "template": "ea in",
                                "attention": "irure ipsum officia adipisicing",
                                "sample": "eu dolore quis ut sed",
                                "material_name": "exercitation",
                                "material_id": "do Duis"
                            }
                        ],
                        "other_material": [
                            {
                                "material_name": "anim mollit Duis labore",
                                "material_url": "non ullamco laborum amet"
                            },
                            {
                                "material_url": "enim exercitation dolore",
                                "material_name": "Ut proident ad sint"
                            }
                        ]
                    }
                },
                "applicant_no": "ut",
                "visa_result_url": [
                    "elit nulla tempor incididunt qui",
                    "in culpa ut",
                    "in culpa fugiat quis veniam"
                ],
                "applicant_id": -65065596
            },
            {
                "applicant_status": 17,
                "operate_desc": "nulla qui officia Duis",
                "material_set": {
                    "paper_material": [],
                    "elec_material": []
                },
                "visa_result_url": [
                    "ipsum commodo non esse"
                ],
                "applicant_id": 85930101,
                "applicant_no": "dolore mollit",
                "embassy_appointment": {
                    "embassy": "voluptate consequat officia",
                    "appointmant_time": "eu minim amet",
                    "take_along_material": {
                        "user_provided": [
                            {
                                "material_id": "voluptate elit sunt ea",
                                "template": "exercitation",
                                "attention": "minim voluptate dolore sunt amet",
                                "material_name": "sint nostrud adipisicing esse laborum",
                                "sample": "commodo"
                            }
                        ],
                        "express_material": [
                            {
                                "material_name": "velit id",
                                "template": "Lorem minim ipsum in",
                                "sample": "veniam do",
                                "attention": "et ex",
                                "material_id": "mollit labore esse ullamco"
                            },
                            {
                                "attention": "minim et magna aliquip cupidatat",
                                "material_id": "mollit sint labore consectetur dolor",
                                "sample": "irure Lorem",
                                "template": "anim commodo minim",
                                "material_name": "esse amet sint Ut ea"
                            }
                        ],
                        "other_material": [
                            {
                                "material_url": "labore consectetur sed",
                                "material_name": "ullamco occaecat tempor"
                            },
                            {
                                "material_name": "adipisicing sed aliqua magna est",
                                "material_url": "in aliqua sed"
                            },
                            {
                                "material_url": "minim",
                                "material_name": "dolore"
                            }
                        ]
                    }
                }
            }
        ],
        "return_express": [
            {
                "tracking_num": "anim nisi non",
                "express_name": "deserunt nulla",
                "goods_type_id": -65448846
            }
        ]
    },
    "notice_desc": "esse elit"
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
🟢200接口异常
🟠400参数不正确
🔴503服务异常
上一页
订单快递邮寄资料信息更新
下一页
资料变更回调通知接口说明
Built with