WorldFirst DocsWorldFirst Docs

queryInvoice需要签名验签

POST /amsin/api/v1/business/fund/queryInvoice

集成商使用此接口向万里汇查询单据支付结果。

报文结构

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

入参

requestId String  REQUIRED

由集成商定义的唯一请求 ID。

更多信息：

  • 最大长度：32 字符

出参

requestId String  REQUIRED

由集成商定义的唯一请求 ID。

更多信息：

  • 最大长度：32 字符

bizOrderId String  

由万里汇定义的业务单 ID。

更多信息：

  • 最大长度：32 字符

payToAmount Amount  REQUIRED

支付金额，即集成商所创建账单的应付金额。

Show child parameters

invoiceStatus String  

单据状态。

可取值如下：

  • INIT：指用户在收银台未发起支付。
  • PROCESSING：指用户在收银台提交支付且支付申请受理成功。
  • FAILED：指单渠道返回失败。
  • SUCCESSFUL：指渠道返回成功，但后续可能会出现退票场景。
  • RETURNED：指渠道返回退票。

result Result  REQUIRED

代表API 接口的调用结果，即集成商是否成功接收通知。

Show child parameters
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
UNKNOWN_EXCEPTIONUAPI failed due to unknown reason.

无需更换requestId，发起重试

PARAM_ILLEGALFIllegal parameters exist. For example, a non-numeric input, or an invalid date.

修改订单信息、更换requestId，发起重试

PROCESS_FAILFA general business failure occurred. Do not retry.

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

INVALID_APIFThe called API is invalid or not active.

检查调用的接口是否正确

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​，发起重试

UN_SUPPORT_BUSINESSFUnsupported business.

使用正确的参数重试