示例代码

NodeJS版 C#版 PHP版

统一参数列表

名称	必要	说明
data	是	见表格
external_company	是	见下文
sign	是	见下文
timer	否	见下文

获取Token

简要描述

用户获取token
token有效时长：120分钟

请求URL

https://APICenter.30post.cn/api/user/gettoken

请求方式

POST ContentType:application/json 以RAW body的json形式传入

参数

{
   		   "appId":"您的appID",
    		"appSecret":"您的appSecret"
}

返回示例

{
    "Success": true,
    "Message": null,
    "Data": "返回的Token字段",
    "IsBeOverdue": false,
    "LogOutUrl": null
}

返回参数说明

参数名	类型	说明
Success	bool	true为成功 false为失败
Message	string	失败后会返回的失败信息
Data	object	成功后返回的数据信息，此接口返回的是Token信息

虚拟卡开卡

简要描述

虚拟卡开卡

请求URL

https://apicenter.30post.cn/api/VirtualCard/Apply

请求方式

POST ContentType:application/json 以RAW body的json形式传入
token 传输采用 Request的Header中，key为Authorization 中加入value值，采用Bearer 模式传输, 把之前获取的token传入进来

参数

    {
        "FirstName":"123",
        "LastName":"123",
        "Telephone":"123123131",
        "BirthDate":"1999-12-12",
        "Email":"122@122.com",
        "City":"1231",
        "PostCode":"121",
        "Remark":"",
        "BillAddress":"",
        "Address":"",
        "tradeNo":""
    }

参数名	必选	类型	说明
FirstName	是	string	姓
LastName	是	string	名
Telephone	是	string	电话
BirthDate	是	string	出生日期
Email	是	string	Email
City	是	string	城市
PostCode	是	string	邮编
Remark	是	string	备注
BillAddress	是	string	收件地址
Address	是	string	地址
tradeNo	是	string	第三方订单编号，第三方数据唯一识别码，不可重复

返回示例

  {
    "Success": true,
    "Message": null,
    "Data": {
        "cardId":"12342143"
        "remainAmount":"123413"
    },
    "IsBeOverdue": false,
    "LogOutUrl": null
}

返回参数说明

参数名	类型	说明
Success	bool	true为成功 false为失败
Message	string	失败后会返回的失败信息
Data	json

参数名	类型	说明
cardId	string	卡编号
remainAmount	decimal	账户余额

卡充值

简要描述

卡充值

请求URL

https://apicenter.30post.cn/api/VirtualCard/AddMoney

请求方式

POST ContentType:application/json 以RAW body的json形式传入
token 传输采用 Request的Header中，key为Authorization 中加入value值，采用Bearer 模式传输, 把之前获取的token传入进来

参数

    {
        "usAmount":"123",
        "cardId":"123",
        "tradeNo":"123123131"
    }

参数名	必选	类型	说明
usAmount	是	string	充值u金额
cardId	是	string	卡编号
tradeNo	是	string	交易编号，用于唯一识别，避免重复

返回示例


  {
    "Success": true,
    "Message": null,
    "Data": {
        "remainAmount":123
    },
    "IsBeOverdue": false,
    "LogOutUrl": null
}

返回参数说明

参数名	类型	说明
Success	bool	true为成功 false为失败
Message	string	失败后会返回的失败信息
Data	object	账户余额

参数名	类型	说明
remainAmount	decimal	账户余额

获取卡基本信息

简要描述

获取卡基本信息

请求URL

https://apicenter.30post.cn/api/VirtualCard/GetBaseInfo

请求方式

POST ContentType:application/json 以RAW body的json形式传入
token 传输采用 Request的Header中，key为Authorization 中加入value值，采用Bearer 模式传输, 把之前获取的token传入进来

参数

    {
        "cardId":"123"
    }

参数名	必选	类型	说明
cardId	是	string	卡编号

返回示例

  {
    "Success": true,
    "Message": null,
    "Data": {
        "amount":25.55,
        "buinessid":"",
        "cardNumber":"卡号",
        "cvvNumber":"",
        "cardNumberLastFour":"",
        "cardType":"",
        "childAccountId":"",
        "createTime":"",
        "email":"",
        "endDate":"",
        "firstName":"",
        "id":"",
        "lastName":"",
        "remarks":"",
        "spendMonth":"",
        "starDate":"",
        "status":1,
        "billAddress":"",
        "address":"",
        "postCode":"",
        "city":"",
        "birthDate":"",
        "telephone":""
    },
    "IsBeOverdue": false,
    "LogOutUrl": null
}

返回参数说明

参数名	类型	说明
Success	bool	true为成功 false为失败
Message	string	失败后会返回的失败信息
Data	json	返回卡信息

Data参数说明

参数名	类型	说明
amount	decimal	账户余额
businessId	string	businessId
cardNumber	string	卡号
cvvNumber	string	CVV
cardNumberLastFour	string	卡号后四位
cardType	string	卡片类型
childAccountId	string	子账号
createTime	string	创建时间
email	string	email
endDate	string	截止日期
firstName	string	firstName
id	string	证件编号
lastName	string	lastName
remarks	string	备注
spendMonth	int	spendMonth
starDate	string	开始日期
status	int	状态
billAddress	string	收账单地址
address	string	地址
postCode	string	邮编
city	string	城市
birthDate	string	生日
telephone	string	电话

消费交易流水接口

简要描述

消费交易流水接口

请求URL

https://apicenter.30post.cn/api/VirtualCard/GetCardTransactionActivity

请求方式

POST ContentType:application/json 以RAW body的json形式传入
token 传输采用 Request的Header中，key为Authorization 中加入value值，采用Bearer 模式传输, 把之前获取的token传入进来

参数

参数名	必选	类型	说明
cardId	是	string	卡编号
current	否	int	当前页
size	否	int	获取数量

{
    "cardId":"",
    "current":1,
    "size":10
}

返回示例

{
    "Success": true,
    "Message":"",
    "Data": 
        {
        "current":1,
        "size":10,
        "total":23,
        "list":[{
            "id":"账单id",
            "reason":"",
            "transactionAmount":23222,
            "transactionTime":"",
            "merchantAddress":"",
            "merchantName":"",
            "status":"",
            "type":"",
            "billItemVos":[{
                "id":"账单id",
                "reason":"",
                "transactionAmount":23222,
                "transactionTime":"",
                "merchantAddress":"",
                "merchantName":"",
                "status":"",
                "type":""
            }],
          }]
      }
    }
  }

返回参数说明

参数名	类型	说明
Success	bool	true为成功 false为失败
Message	string	失败后会返回的失败信息
Data	json	返回卡信息

Data参数说明

参数名	类型	说明
current	int	当前页
size	int	数量
total	int	总数
list	array	见参数说明

list参数说明

参数名	类型	说明
id	string	账单id
transactionAmount	decimal	交易额
transactionTime	string	交易时间
merchantAddress	string	地址
merchantName	string	店家
status	string	状态
type	string	类型
billItemVos	json数组	同list参数

交易列表接口(暂时不用)

简要描述

交易列表接口

请求URL

https://apicenter.30post.cn/api/VirtualCard/tradeIndex

请求方式

POST ContentType:application/json 以RAW body的json形式传入
token 传输采用 Request的Header中，key为Authorization 中加入value值，采用Bearer 模式传输, 把之前获取的token传入进来

参数

参数名	必选	类型	说明
cardId	是	string	卡编号
year	是	int	year
month	是	int	month

{
    "cardId":"",
    "year":2025,
    "month":8
}

返回示例

  {
    "success": 0,
    "Message":"",
    "data": [{
          "id":"账单id",
          "reason":"",
        "transactionAmount":23222,
        "transactionTime":"",
        "status":"",
        "billItemVos":[],
      }]
    }
  }

返回参数说明

参数名	类型	说明
Success	bool	true为成功 false为失败
Message	string	失败后会返回的失败信息
Data	json	返回卡信息

Data参数说明

参数名	类型	说明
id	string	账单id
transactionAmount	decimal	交易额
transactionTime	string	交易时间
status	string	状态
billItemVos	json数组	——

获取交易详情接口(暂时不用)

简要描述

获取交易详情接口

请求URL

https://apicenter.30post.cn/api/VirtualCard/tradeDetail

请求方式

POST ContentType:application/json 以RAW body的json形式传入
token 传输采用 Request的Header中，key为Authorization 中加入value值，采用Bearer 模式传输, 把之前获取的token传入进来

参数

{
    "cardId":"",
    "id":""
}

参数名	必选	类型	说明
cardId	是	string	卡编号
id	是	string	账单id

{
    "cardId":"",
    "id":""
}

返回示例

  {
    "success": 0,
    "data": {
          "CardId":"",
          "cardName":"",
        "cardNumber":23222,
        "id":"",
        "merchantAddress":"",
        "merchantName":"",
        "reason":"",
        "status":"",
        "transactionAmount":"",
        "transactionTime":"",
        "billItemVos":[],
      }
    }
  }

返回参数说明

参数名	类型	说明
CardId	string	卡编号
cardName	string	卡名
cardNumber	string	卡号
id	string	账单id
merchantAddress	string	merchantAddress
merchantName	string	merchantName
reason	string	原因
status	string	状态
transactionAmount	string	流水额
transactionTime	string	时间
type	string	种类

修改卡片信息

简要描述

修改卡片信息

请求URL

https://APICenter.30post.cn/api/virtualCode/updatecardinfo

请求方式

POST ContentType:application/json 以RAW body的json形式传入
token 传输采用 Request的Header中，key为Authorization 中加入value值，采用Bearer 模式传输, 把之前获取的token传入进来

参数

{
    "cardId":"",
    "BillAddress":"",
    "City":"",
    "FirstName":"",
    "LastName":"",
    "Remark":"",
    "PostCode":"",
}

参数名	必选	类型	说明
BillAddress	是	string	账单地址
City	是	string	城市
FirstName	否	string	姓
LastName	否	string	名
Remark	否	string	备注
PostCode	否	string	邮编

返回示例

  {
    "Success": true,
    "Message": null,
    "Data": null,
    "IsBeOverdue": false,
    "LogOutUrl": null
}

返回参数说明

参数名	类型	说明
Success	bool	true为成功 false为失败
Message	string	失败后会返回的失败信息
Data	object	null

扣减卡可用余额

简要描述

扣减卡可用余额

请求URL

https://apicenter.30post.cn/api/VirtualCard/Surplus

请求方式

POST ContentType:application/json 以RAW body的json形式传入
token 传输采用 Request的Header中，key为Authorization 中加入value值，采用Bearer 模式传输, 把之前获取的token传入进来

参数

    {
        "money":"123",
        "cardId":"123",
        "tradeNo":""
    }

参数名	必选	类型	说明
money	是	string	扣减u金额
cardId	是	string	卡编号
tradeNo	是	string	订单编号

返回示例

  {
    "Success": true,
    "Message": null,
    "Data": {
        "remainAmount":1232
    },
    "IsBeOverdue": false,
    "LogOutUrl": null
}

返回参数说明

参数名	类型	说明
Success	bool	true为成功 false为失败
Message	string	失败后会返回的失败信息
Data	json

Data说明

参数名	类型	说明
remainAmount	decimal	账户余额

获取卡充值交易接口

简要描述

获取卡充值交易接口

请求URL

https://apicenter.30post.cn/api/VirtualCard/GetTranList

请求方式

POST ContentType:application/json 以RAW body的json形式传入
token 传输采用 Request的Header中，key为Authorization 中加入value值，采用Bearer 模式传输, 把之前获取的token传入进来

参数

参数名	必选	类型	说明
cardId	是	string	卡编号
current	否	int	当前页默认1
size	否	int	数量默认10

{
    "cardId":"",
    "current":1,
    "size":2
}

返回示例

  {
    "Success": true,
    "Message":"",
    "Data":  {
        "current": 1,
        "list": [
            {
                "amount": 20.0,
                "balance": 0.0,
                "cardId": "981056418360770566",
                "description": "Add Fund to Card 4437",
                "id": "981097482845073482",
                "initiated": "2025-03-05 10:26:54",
                "status": "Completed",
                "type": "Debit"
            },
            {
                "amount": 20.0,
                "balance": 0.0,
                "cardId": "981056418360770566",
                "description": "Create Card 4437",
                "id": "981056418411102304",
                "initiated": "2025-03-05 07:43:43",
                "status": "Completed",
                "type": "Debit"
            }
        ],
        "size": 10,
        "total": 2
    },
    }
  }

返回参数说明

参数名	类型	说明
Success	bool	true为成功 false为失败
Message	string	失败后会返回的失败信息
Data	json	返回交易信息

Data参数说明

参数名	类型	说明
current	int	当前页
size	int	数量
total	int	总数
list	array	交易列表

Data参数说明

参数名	类型	说明
id	string	id
cardId	string	卡Id
amount	decimal	交易金额
balance	decimal	balance
description	string	描述
initiated	datetime	initiated
status	string	状态
type	string	类型