创建虚拟卡

简要描述

  • 创建虚拟卡

请求方式

  • POST open/api/card/create

参数

参数名必选类型长度说明
vidstring卡段id(USD)
+cardHolderobject持卡人
  └firstNamestring32持卡人姓 [a-zA-Z]{1,32}
  └lastNamestring32持卡人名 [a-zA-Z]{1,32}
depositString24充值金额(美元), 1000代表 10.00
orderNostring64自定义客户交易流水id {1,64}
callbackUrlstring256回调地址 {1,256}

注意事项

  • deposit 为虚拟卡充值(初始存款)金额,1 代表 1 美分,即 1000 代表 10.00,本系统中所有金额(例如balance)都采用此规则
  • 开卡充值金额范围:10 USD - 5000 USD

请求示例

{
    "cardHolder": {
        "firstName": "Milton",
        "lastName": "Schmitt"
    },
    "deposit": "1000",
    "vid": "USD",
    "orderNo": "v_5bc814",
    "callbackUrl": "https://www.baidu.com"
}

返回参数说明

参数名类型说明
successboolean成功标志
errorboolean错误标志
codelong返回编码
msgstring返回信息
traceIdstringtraceId
modelobject返回内容

返回对象说明

参数名类型说明
activeLinkstring卡激活连接

返回示例

{
    "code":"0",
    "msg":"成功",
    "model":{
        "activeLink":"http://www.***.com/login?wallet=8012&token=eyJraWQiOiIybWE0ZW51MWtkdnc1Ym85eHNmcGkzZ2NqenJ0NnE3OHlsMGgiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiI3NGI5ZGM1ZmIyZTI5NjcxYjVjMzg0NGY3YTdkMzc2YSIsIm5hbWUiOiI1MDU4ODQ5NzhAcXEuY29tIiwiZW1haWwiOiI1MDU4ODQ5NzhAcXEuY29tIiwiYXVkIjoidXJuOm15LXJlc291cmNlLXNlcnZlciIsImlzcyI6Imh0dHBzOi8vd2ViM2F1dGguaW8iLCJpYXQiOjE3NDg5MzQxODcsImV4cCI6MTc0ODkzNzc4N30.i4hEwiajbiP4TbdxUFlxb-Xc7Bxf4-1TbELz9zn3tFexRePJxianb7n1_b9e8LCC5hrYWKD_12_YjNC2L7EtAbZgQ5p6Svy7TES7heL9x1MGRiiju_mIZOy712KLbnTo5_YmY4Nt4eO6-lhrUJPL5D8ZZe9k7DEA7ASuAfwf25fEhy1CGVUqRWSML6sq4o2tWLln1jjtKqZJWP95UBpsk_YIUUTTLAPifx0aqdFScdMpNjx_egBxYTG8E2ggqX5NUIoAu5wQgvrLqLaiRn7n7rKgdrFtIVNsQUjfnlc5_uZewYn_ZaVwu7wj78_5UBNy59nJtQGyPrFR2owAXY70HA"
    },
    "traceId":"665597457b9b37cb000187a035002030",
    "success":true,
    "error":false
}

备注

  • 更多返回错误代码请看首页的错误代码描述