创建订单

开发中

vgs_dev

https://dapi.visageniusglobal.com

POST

/openvisa/order_add

一、变更说明

变更内容	变更人	变更时间
修改order_express_address 为可选项（创建或者支付订单有一次提交即可）	周建成	2024-08-26

二、鉴权

每个调用方都会得到一个appid、access_key、secret_key，请求时，将：Date、X-Appid、Authorization放到请求头中，其中：

1、Date/X-Date

报文创建的日期和时间（格林尼治标准时间，而不是本地时间），例如：Date: Wed, 21 Oct 2022 07:28:00 GMT。这个时间上下误差不能超过5分钟，否则会报错。

2、X-Appid

我方给的appid

3、Authorization

将access_key、appid、date三个字符串拼接起来，中间以\n分割，例如：

string s = access_key + '\n' + appid + '\n' + date

然后将该字符串做hmac_sha1，得到的结果做base64，

string t = base64(hmac_sha1(secret_key, s))，

最后，Authorization的值如下：

string Authorization = "Basic " + t

请求参数

Header 参数

X-Date

string

可选

示例值:

X-Appid

string

可选

示例值:

Authorization

string

可选

示例值:

X-Request-Id

string

必需

示例值:

Body 参数application/json

product_id

integer

商品id

必需

contact_number

string

联系人电话

必需

contact_name

string

联系人姓名

必需

pay_amount

integer

订单支付总金额

必需

以分为单位

depart_date

string

出行日期

必需

effect_date

string

签证生效日期

可选

根据商品里面的need_effect_date来判断

order_express_address

object

订单回寄地址

可选

创建订单或者订单支付时填写

addressee

string

收件人

必需

mobile_phone

string

手机号码

必需

province_code

string

省份code

必需

city_code

string

城市code

必需

county_code

string

区code

必需

没有区时，默认传0

detail_address

string

详细地址

必需

applicant_set

array [object {3}]

必需

identity_id

enum<integer>

身份id

必需

0在职人员 1自由职业者 2退休人员 3在校学生 4学龄前儿童 5通用身份

枚举值:

012345

applicant_name

string

申请人姓名

可选

applicant_no

string

第三方申请人编号

必需

示例

{
    "depart_date": "2023-12-23",
    "product_id": 11234,
    "applicant_set": [
        {
            "identity_id": 0,
            "applicant_no": "test123",
            "applicant_name": "chenyang-test_add"
        }
    ],
    "order_express_address": {
        "addressee": "chenyang-test_add",
        "detail_address": "detail_address",
        "county_code": "110101",
        "city_code": "110000",
        "province_code": "110000",
        "mobile_phone": "13333333333"
    },
    "pay_amount": 1,
    "contact_number": "13333333333",
    "contact_name": "in anim Excepteur",
    "effect_date": "2023-12-23"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://dapi.visageniusglobal.com/openvisa/order_add' \
--header 'X-Date: ' \
--header 'X-Appid: ' \
--header 'Authorization: ' \
--header 'X-Request-Id: {{$guid}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "depart_date": "2023-12-23",
    "product_id": 11234,
    "applicant_set": [
        {
            "identity_id": 0,
            "applicant_no": "test123",
            "applicant_name": "chenyang-test_add"
        }
    ],
    "order_express_address": {
        "addressee": "chenyang-test_add",
        "detail_address": "detail_address",
        "county_code": "110101",
        "city_code": "110000",
        "province_code": "110000",
        "mobile_phone": "13333333333"
    },
    "pay_amount": 1,
    "contact_number": "13333333333",
    "contact_name": "in anim Excepteur",
    "effect_date": "2023-12-23"
}'

返回响应

🟢200成功

application/json

Body

0成功，其余失败

ret

integer

描述信息

必需

ret非0时，显示为错误描述信息

msg

string

必需

body

object

必需

order_id

integer

订单id

必需

pay_status

enum<integer>

支付状态

必需

0,待支付 1,已支付 2,已退款

枚举值:

012

order_status

enum<integer>

订单状态

必需

0,已取消 1,待上传资料 2,待填写申请表 3,待支付 4,待邮寄资料 5,办理中 6,已发货 7,待评价 8,已完成 9,已删除 10,待选择赴馆日期

枚举值:

012345678910

applicant_set

array [object {4}]

必需

{"ret":0,"msg":"ok","body":{"order_status":1,"pay_status":0,"order_id":1000012682,"applicant_set":[{"applicant_no":"test123","applicant_name":"chenyang-test_add","applicant_id":35105,"applicant_status":1}]}}

🟢200接口异常

🟠400参数不正确

🔴503服务异常

商品详情查询

订单支付

创建订单

一、变更说明#

二、鉴权#

1、Date/X-Date#

2、X-Appid#

3、Authorization#

请求参数

示例代码

返回响应

一、变更说明

二、鉴权

1、Date/X-Date

2、X-Appid

3、Authorization