applyCard需要签名验签
集成商可调用此接口,向万里汇申请万里付卡片。
报文结构
万里汇接口报文结构包括:请求头、请求体、响应体。
请求头
入参
requestId String REQUIRED
针对本次申卡请求,由集成商指定的唯一请求号。
更多信息:
- 最大长度:32 字符
cardNickName String
由用户定义的卡昵称,可以帮助用户更方便地管理多张万里付卡片。
更多信息:
- 最大长度:120 字符
currency String
币种信息,为 ISO 4217 标准规定的三位字母货币代码。
现阶段字段取值范围为:USD
有关此字段的更多信息:
- 此字段的默认取值为
USD
- 最大长度:3 字符
contactEntityId String
由集成商定义的企业联系人唯一标识ID。
- 当用户需要使用企业联系人信息申请万里付卡片时,此字段为必传。
- 调用 queryContactList 接口以获取企业联系人唯一标识ID。
env Env REQUIRED
转账环境。
出参
result Result REQUIRED
代表API 接口的调用结果。
requestId String REQUIRED
针对本次申卡请求,由集成商指定的唯一请求号。
此字段只有当 result.resultStatus =S
时才会按需返回。
更多信息:
- 最大长度:32 字符
status String REQUIRED
代表万里付卡片的申请状态。
取值范围为:
SUCCESS
:申请成功PROCESSING
:已申请,受理中FAIL
:申请失败
此字段只有当 result.resultStatus =S
时才会按需返回。
API Explorer
请求
URL
请求体
响应
响应体
响应处理
集成商调用接口后,万里汇返回集成商API调用结果。result.resultStatus 取值范围为:
result.resultCode:系统结果码
结果码 | 值 | 结果码信息 | 行动建议 |
---|---|---|---|
SUCCESS | S | Success | |
PARAM_ILLEGAL | F | Illegal parameters exist. For example, a non-numeric input, or an invalid date. | 参考API文档页面,确认请求头和传参是否正确。 |
UNKNOWN_EXCEPTION | U | API failed due to unknown reason. | 服务器错误,若稍后重试问题依旧,联系万里汇技术支持以解决问题。 |
REPEAT_REQ_INCONSISTENT | F | Repeated requests are inconsistent. | 重试请求不一致。需保证所有请求参数均相同。 |
RISK_REJECT | F | Risk reject allow appeal | 请联系万里汇技术支持。 |
result.resultCode:业务结果码
结果码 | 值 | 结果码信息 | 行动建议 |
---|---|---|---|
SYSTEM_ERROR | F | System error. | 请勿重试,联系万里汇技术支持了解详情。 |
CONTRACT_NOT_EXIST | F | The contract check has failed. | 检查合约状态后重试。 |
USER_NOT_EXIST | F | The user does not exist. | 使用正确的用户信息重试。 |
USER_INFORMATION_INCOMPLETE | F | firstName & lastName englishNameInfoResult is null | 用户信息不完整,补充完整用户信息,重试失败后请联系万里汇技术支持。 |
APPLY_CARD_NUMBER_LIMIT | F | Apply card number limit. | 请联系万里汇技术支持。 |
NOT_ENOUGH_AMOUNT_IN | F | The user's recent cash flow is insufficient. | 用户近期资金流水不足,请联系万里汇技术支持。 |
USER_LEVEL_NOT_MATCH | F | User level not match. | 联系万里汇技术支持以解决问题。 |
ACCESS_TOKEN_EXPIRED | F | The access token expired. | 刷新token接口以重新获取访问令牌(access token),或联系万里汇技术支持以解决问题。 |
AUTHORIZATION_NOT_EXIST | F | The authorization does not exist. | 当前授权关系不存在,请联系万里汇技术支持检查授权关系。 |