WorldFirst DocsWorldFirst Docs

applyLoan需要签名验签

POST /amsin/alipay/business/loan/applyLoan

集成商可调用此接口申请使用授信额度。

在调用此接口之前，调用 consultLoan 接口以获取入参所需的相关参数。

报文结构

万里汇接口报文结构包括：请求头，请求体。关于头信息，详见：

入参

requestId String  REQUIRED

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

更多信息：

  • 此为幂等字段。

creditGrantNo String  REQUIRED

由万里汇定义的唯一单据号，用于标识每笔授信单据。

productCode String  REQUIRED

产品代码。可取值范围：

  • ​AMAZON_VC_FACTORING_LOAN​

loanAmount Amount  REQUIRED

可支用金额，默认为授信额度。

Show child parameters

repayMode String  REQUIRED

还款方式。可取值范围：

  • ​REPAY_OUTRIGHT​：还本付息

interestRate Rate  REQUIRED

借款利率。

Show child parameters

numOfPeriod Integer  REQUIRED

贷款总期数。

出参

result Result  REQUIRED

代表API 接口的调用结果。

Show child parameters

loanOrderNo String  REQUIRED

由万里汇定义的唯一支用单号，用于标识每笔支用记录。

API Explorer

请求

URL
请求体

响应

响应体

响应处理

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

result.resultStatus

描述

S

接口调用成功

F

接口调用失败。

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

U

调用结果未知，需重试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文档页面，确认请求头和传参是否正确。

PROCESS_FAILFA general business failure occurred. Do not retry.

需要人工介入，联系万里汇技术支持以解决此问题。

UNKNOWN_EXCEPTIONUAPI failed due to unknown reason.

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

REQUEST_TRAFFIC_EXCEED_LIMITUThe request traffic exceeds the limit.

重试，若问题依旧，联系万里汇技术支持

OAUTH_FAILFOAuth process failed.

联系万里汇技术支持了解详情。

INVALID_APIFThe called API is invalid or not active.

确认是否调用正确的API。

INVALID_CLIENTFThe client is invalid.

Client ID不存在或无效。

INVALID_SIGNATUREFThe signature is invalid.

确认请求正确加签。

METHOD_NOT_SUPPORTEDFThe server does not implement the requested HTTP method.

确认HTTP请求方法为POST

result.resultCode：业务结果码

结果码值结果码信息行动建议
UNRELATED_US_SUB_ACCOUNT_ERRORFThe US sub account is not associated.

关联US子账户后重试。

LOAN_USER_NOT_MATCHFThe credit grant number is not matched with the current user.

确认授信单和用户匹配后重试。

ACCESS_CODE_LOSE_EXCEPTIONFThe access code does not exist.

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

REAL_TIME_COLLECTION_NOT_ENABLED_ERRORFReal time collection is not enabled.

当前实时归集不可用，请联系万里汇技术支持以解决问题。

CREDIT_ORDER_ALREADY_LOANFThe credit grant order has been used.

更换授信单后重试。若问题依旧，联系万里汇技术支持以解决问题。

REPAY_MODE_NOT_SUPPORTEDFThe repay mode is not supported.

使用正确的还款方式重试。

LOAN_TERM_NOT_SUPPORTEDFThe loan periods is not supported.

使用正确的贷款期限重试。

LOAN_AMOUNT_ILLEGALFThe loan amount is not supported.

使用正确的支用金额重试。

LOAN_AMOUNT_NOT_MATCHFThe loan amount does not match.

确认支用金额与授信额度一致后重试。