通用接口

国家/地区列表

此接口更新频率极低，请用户将数据进行本地化进行调用。

POST /merchant/core/mcb/common/region

请求

参数

类型

是否必传

备注

响应

参数

类型

是否必传

描述

code

String

是

国家/地区代码 ISO 3166-1 alpha-2

standardCode

String

是

国家/地区代码 ISO 3166-1 alpha-3

name

String

是

国家/地区名称

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "code": "AU",
            "standardCode": "AUS",
            "name": "Australia"
        },
        {
            "code": "BD",
            "standardCode": "BGD",
            "name": "Bangladesh"
        }
    ]
}

城市列表

此接口更新频率极低，请用户将数据进行本地化进行调用。

POST /merchant/core/mcb/common/city

请求

参数

类型

是否必传

备注

regionCode

String

false

国家/地区代码 ISO 3166-1 alpha-2

响应

参数

类型

是否必传

描述

code

String

是

城市代码

name

String

是

城市名称

country

String

是

国家/地区代码 ISO 3166-1 alpha-2

countryStandardCode

String

是

国家/地区代码 ISO 3166-1 alpha-3

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "code": "AUK",
            "name": "test",
            "country": "AU",
            "countryStandardCode": "AUB",
        }
    ]
}

城市列表-v2

包含了省份/州/地区、城市两个层级。

此接口更新频率极低，请用户将数据进行本地化进行调用。

POST /merchant/core/mcb/common/v2/city

请求

参数

类型

是否必传

备注

regionCode

String

false

国家/地区代码 ISO 3166-1 alpha-2

响应

参数

类型

是否必传

描述

code

String

是

城市代码

name

String

是

城市名称

country

String

是

国家/地区代码 ISO 3166-1 alpha-2

countryStandardCode

String

是

国家/地区代码 ISO 3166-1 alpha-3

parentCode

String

是

父级code。0是最高层级；代表省份/州/地区

children

List

是

子城市列表

children[0].code

String

是

城市代码

children[0].name

String

是

城市名称

children[0].country

String

是

国家/地区代码 ISO 3166-1 alpha-2

children[0].countryStandardCode

String

是

国家/地区代码 ISO 3166-1 alpha-3

children[0].parentCode

String

是

父级code。0是最高层级；代表省份/州/地区

children[0].children

List

是

子城市列表

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "code": "AU-ACT",
            "name": "澳大利亚首都特区",
            "parentCode": "0",
            "country": "AU",
            "countryStandardCode": "AUS",
            "children":
            [
                {
                    "code": "AU-ACT-80100",
                    "name": "堪培拉",
                    "parentCode": "AU-ACT",
                    "country": "AU",
                    "countryStandardCode": "AUS",
                    "children":
                    []
                }
            ]
        }
    ]
}

手机区号列表

此接口更新频率极低，请用户将数据进行本地化进行调用。

POST /merchant/core/mcb/common/mobileAreaCode

请求

参数

类型

是否必传

备注

响应

参数

类型

是否必传

描述

code

String

是

电话区号

name

String

是

所属地区名称

areaCode

String

是

所属地区代码 ISO 3166-1 alpha-2

language

String

是

地区语言

响应示例

{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "code": "+1",
            "name": "Canada",
            "areaCode": "CA",
            "language": "en_US"
        }
    ]
}

上传文件

content-type=multipart/form-data；此接口签名请生成一个空对象进行签名

只支持jpg、png、pdf格式；文件大小不能超过2M

POST /merchant/core/mcb/common/file/upload

请求

参数

类型

是否必传

备注

工单-提交

POST /merchant/core/mcb/work/submit

请求

param

Type

Required

Remark

merchantOrderNo

String

true

商户订单号. 长度[20...40]

title

String

true

标题. 长度[1...255]

target

String

true

对象. 长度[1...255] 例如：卡号

content

String

false

内容. 长度[0...1000]

files

List

false

文件ID. 调用文件上传接口 upload file

tradeType

String

true

类型. CARD_ACTIVE: 卡片激活; OTHER: 其它

响应

Param

Type

Required

Remark

merchantOrderNo

String

true

商户订单号

orderNo

String

true

平台订单号

title

String

true

标题

target

String

true

对象

content

String

false

内容

tradeType

String

true

工单类型. CARD_ACTIVE: 卡片激活; OTHER: 其它

tradeStatus

String

true

工单事件状态. wait_process: 待处理; processing: 处理中;

success: 成功;

fail: 失败

remark

String

false

备注

createTime

Long

true

Millisecond timestamp

updateTime

Long

true

Millisecond timestamp

响应示例

{
  "merchantOrderNo": "13243897979979797999008085",
  "orderNo": "WORK-202508071953472304731676672",
  "title": "ApplePay",
  "target": "5533700042831234",
  "content": "激活",
  "tradeType": "CARD_ACTIVE",
  "tradeStatus": "processing",
  "remark": null,
  "createTime": 1754607865000,
  "updateTime": 1754648044000
}

工单列表

POST /merchant/core/mcb/work/list

请求

param

Type

Required

Remark

merchantOrderNo

String

false

商户订单号

orderNo

String

false

平台订单号

target

String

false

对象

tradeType

String

false

工单类型. CARD_ACTIVE: 卡片激活; OTHER: 其它

tradeStatus

String

false

工单事件状态 wait_process: 待处理; processing: 处理中;

success: 成功;

fail: 失败

响应

Param

Type

Required

Remark

merchantOrderNo

String

true

商户订单号

orderNo

String

true

平台订单号

title

String

true

标题

target

String

true

对象

content

String

false

内容

tradeType

String

true

工单类型. CARD_ACTIVE: 卡片激活; OTHER: 其它

tradeStatus

String

true

工单事件状态. wait_process: 待处理; processing: 处理中;

success: 成功;

fail: 失败

remark

String

false

备注

createTime

Long

true

Millisecond timestamp

updateTime

Long

true

Millisecond timestamp

响应示例

{
  "success": true,
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "total": 1,
    "records": [
      {
        "merchantOrderNo": "13243897979979797999008085",
        "orderNo": "WORK-202508071953472304731676672",
        "title": "ApplePay",
        "target": "5533700042831234",
        "content": "激活",
        "tradeType": "CARD_ACTIVE",
        "tradeStatus": "processing",
        "remark": null,
        "createTime": 1754607865000,
        "updateTime": 1754648044000
      }
    ]
  }
}

Previous快速开始 Next账户

Last updated 15 days ago