WorldFirst DocsWorldFirst Docs

applyCard需要签名验签

POST /amsin/api/v1/business/worldcard/applyCard

集成商可调用此接口，向万里汇申请万里付卡。

报文结构

万里汇接口报文结构包括：请求头、请求体、响应体。

请求头

字段名

是否必传

范例

说明

Client-Id

是

Client-Id: *****

关于这些参数的解释说明，详见：请求头。

Signature

是

Signature: algorithm=RSA256, keyVersion=2, signature=*****

Content-Type

是

Content-Type: application/json; charset=UTF-8

Request-Time

是

Request-Time: 2019-04-04T12:08:56+08:00

Connected-CustomerId

否（有条件要求）

Connected-CustomerId: *****

注意此字段

当平台客户操作商户账户时需要传递

Access-Token

有条件要求

Access-Token: ******

注意此字段

当用 OAUTH 授权时需要传递

入参

requestId String  REQUIRED

针对本次申卡请求，由集成商指定的唯一请求号。

更多信息：

  • 最大长度：32 字符

cardNickName String  

由用户定义的卡昵称，可以帮助用户更方便地管理多张万里付卡。

更多信息：

  • 最大长度：120 字符

contactEntityId String  

由集成商定义的企业联系人唯一标识ID。

  • 当用户需要使用企业联系人信息申请万里付卡时，此字段为必传。
  • 调用 queryContactList 接口以获取企业联系人唯一标识ID。

env Env  REQUIRED

环境信息。

Show child parameters

budgetAccountId String  

预算账户ID。

当用户需要使用预算账户申请万里付卡时，此字段为必传。

perCardLimitMax Long  

单张万里付卡交易的最大限额，为基于当前货币最小单位的数额。此限额为持续累计，不会清零。

注意：

如您需要对单张万里付卡进行限额管理，请在此字段中传入相应的值。

出参

result Result  REQUIRED

代表API 接口的调用结果。

Show child parameters

requestId String  REQUIRED

针对本次申卡请求，由集成商指定的唯一请求号。

此字段只有当 result.resultStatus =S 时才会按需返回。

更多信息：

  • 最大长度：32 字符

status String  REQUIRED

代表万里付卡的申请状态。

取值范围为：

  • SUCCESS：申请成功
  • PROCESSING：已申请，受理中
  • FAIL：申请失败

此字段只有当 result.resultStatus =S 时才会按需返回。

API Explorer

请求

URL
请求体

响应

响应体

响应处理

集成商调用接口后，万里汇返回集成商API调用结果。result.resultStatus 取值范围为：

result.resultStatus

描述

S

API请求成功。

F

API请求失败。

失败原因参见结果码（即 result.resultCode 和 result.resultMessage ）

U

API响应结果为UNKNOWN（未知）时，需重试API请求。

重试策略：

  • 重试次数上限：7次
  • 重试时间间隔：5分钟、10分钟、20分钟、40分钟、80分钟、160分钟、320分钟

如果问题依旧，请联系万里汇技术支持。

result.resultCode：系统结果码

结果码值结果码信息行动建议
SUCCESSSSuccess
PARAM_ILLEGALFIllegal parameters exist. For example, a non-numeric input, or an invalid date.

参考API文档页面，确认请求头和传参是否正确。

UNKNOWN_EXCEPTIONUAPI failed due to unknown reason.

服务器错误，若稍后重试问题依旧，联系万里汇技术支持以解决问题。

REPEAT_REQUESTFRepeated request

更换 requestId，发起重试。

RISK_REJECTFRequest rejected due to risk concerns.

请联系万里汇技术支持。

result.resultCode：业务结果码

结果码值结果码信息行动建议
SYSTEM_ERRORFSystem error.

请勿重试，联系万里汇技术支持了解详情。

CONTRACT_NOT_EXISTFThe contract check has failed.

检查合约状态后重试。

USER_NOT_EXISTFThe user does not exist.

使用正确的用户信息重试。

USER_INFORMATION_INCOMPLETEFThe user's English name information cannot be empty.

用户信息不完整，补充完整用户信息，重试失败后请联系万里汇技术支持。

CONTACT_ENTITY_ID_MATCH_MULTIPLEFMatch multiple contactEntityId.

匹配多个contactEntityId，用户需要输入一个指定的contactEntityId。输入指定contactEntityId后发起重试。

APPLY_CARD_NUMBER_LIMITFApply card number limit.

请联系万里汇技术支持。

NOT_ENOUGH_AMOUNT_INFThe user's recent cash flow is insufficient.

用户近期资金流水不足，请联系万里汇技术支持。

USER_LEVEL_NOT_MATCHFUser level not match.

联系万里汇技术支持以解决问题。

ACCESS_TOKEN_EXPIREDFThe access token expired.

刷新token接口以重新获取访问令牌（access token），或联系万里汇技术支持以解决问题。

AUTHORIZATION_NOT_EXISTFThe authorization does not exist.

当前授权关系不存在，请联系万里汇技术支持检查授权关系。