inquiryStatementDetail需要签名验签

POST /amsin/api/v1/business/account/inquiryStatementDetail

集成商可调用此接口获取某一笔交易账单的详细信息。

在调用此接口之前,调用 inquiryStatementList 接口以获取万里汇账单动账流水单号。

报文结构

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

请求头

字段名

是否必传

范例

说明

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 授权时需要传递

入参

accountingBizNo String  REQUIRED

万里汇账单动账流水单号。

出参

result Result  REQUIRED

代表 API 接口调用结果。

Show child parameters

responseId String  REQUIRED

由万里汇定义,用于唯一标识某次响应的ID。

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

transactionId String  CONDITIONAL

由万里汇定义、每笔交易的唯一ID。当一笔交易中包含多条交易数据时,所有交易数据共用同一ID。

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

transactionType为以下取值时,此字段为必传

  • TRANSFER转账
  • TRANSFER_REFUND转账退款
  • WITHDRAWAL提款
  • WITHDRAWAL_REFUND提款退款
  • CONVERSION兑换
  • CONVERSION_DEAL货币兑换(锁汇)
  • CHARGE服务费
  • CHARGE_REFUND服务费退款
  • DEDUCTION扣款
  • FUND_COLLECTION:归集

extTransactionId String  

由集成商定义、每笔转账的唯一ID。

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

更多信息:

  • 最大长度:256 字符

transactionStatus String  REQUIRED

动账单的状态。取值范围:

  • INIT:已创建
  • PROCESSING处理中
  • PENDING:挂起
  • SUCCESS成功
  • FAIL:失败
  • REFUNDED: 已退款

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

transactionTime String  REQUIRED

动账单的创建时间。

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

更多信息:

  • 值遵循 ISO 8601 标准格式。例如,“2019-11-27T12:01:01+08:00”。

transactionType String  REQUIRED

动账类型。

取值包括:TRANSFER 转账,COLLECTION 收款等。完整取值详见:transactionType

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

transactionAmount Amount  REQUIRED

交易净金额。

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

金额与netAmount一致,可正可负,正负代表资金流向。

  • 出账时,该字段为负数;
  • 入账时,该字段为正数。
Show child parameters

originalTransactionAmount Amount  REQUIRED

交易的原始付款金额。

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

Show child parameters

feeAmount Amount  CONDITIONAL

手续费金额。

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

transactionType为以下取值时,此字段为必传

  • TRANSFER: 转账
  • TRANSFER_REFUND: 转账退款
  • WITHDRAWAL提款
  • WITHDRAWAL_REFUND提款退款
  • CONVERSION兑换
  • CONVERSION_DEAL货币兑换(锁汇)
  • CHARGE服务费
  • CHARGE_REFUND服务费退款
  • DEDUCTION扣款
  • FUND_COLLECTION:归集
Show child parameters

netAmount Amount  CONDITIONAL

净金额。

计费金额为交易发生时万里汇收取的手续费。

公式netAmount = originalTransactionAmount - feeAmount

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

transactionType为以下取值时,此字段为必传

  • TRANSFER转账
  • CHARGE服务费
  • PAYMENT支付
  • CASH_BACK:返现
Show child parameters

receiveAmount Amount  CONDITIONAL

算汇后的收款金额。

公式:

receiveAmount = netAmount * foreignExchangeQuote.quotePrice

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

Show child parameters

accountBalance Amount  REQUIRED

转账后的实时账户余额。

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

Show child parameters

fundMoveDetail FundMoveDetail  REQUIRED

资金流的细节,比如收款人和付款人的信息等。

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

Show child parameters

operatorInfo OperatorInfo  CONDITIONAL

发起交易单的人员信息。

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

该字段只有在操作万里汇门户而产生交易单时才会返回。

Show child parameters

foreignExchangeQuote Quote  CONDITIONAL

转账的外汇汇率信息。

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

transactionType为以下取值时,此字段为必传

  • TRANSFER转账
  • WITHDRAWAL提款
  • CONVERSION兑换
  • CONVERSION_DEAL货币兑换(锁汇)
  • CHARGE:服务费
Show child parameters

refundForeignExchangeQuote Quote  CONDITIONAL

退款的外汇汇率信息。

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

transactionType为以下取值时,此字段为必传

  • TRANSFER_REFUND转账退款
  • WITHDRAWAL_REFUND提款退款
  • CHARGE_REFUND:服务费退款
Show child parameters

balanceType String  

该字段表示客户拥有的不同余额类型。

客户在不同业务场景下,可使用不同的余额类型对资金余额做分隔管理,作用是为了风险管控。

此字段的可取值为:

  • NORMAL_BALANCE: 普通余额类型(即电商余额类型)。(默认)
  • SAME_NAME_TOP_UP_BALANCE: 同名充值余额类型。

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

当该字段为空时,NORMAL_BALANCE为默认取值。

accountingBizNo String  REQUIRED

万里汇账单动账流水单号。

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

goodsName String  

商品名称。

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

goodsAmount Amount  

商品金额。

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

Show child parameters

platformFeeAmount Amount  REQUIRED

第三方平台服务费。

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

Show child parameters

failReason Result  CONDITIONAL

失败原因。

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

transactionStatus 字段取值为 ​FAIL​ 时,此字段为必传

Show child parameters

combinedTransactionList Array<RelatedStatement>  REQUIRED

关联交易列表,返回与所查询动账相关联的所有交易。

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

Show child parameters
API Explorer

请求

URL
请求体

响应

响应体

响应信息处理

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

Result status

描述

S

接口调用成功

F

接口调用失败,具体失败原因见result.resultCode

U

调用结果未知,需重试API请求。若问题依旧,联系万里汇技术支持。

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:业务结果码

结果码结果码信息行动建议
USER_NOT_EXISTFThe user does not exist.

使用正确的用户信息重试

SYSTEM_ERRORFSystem error.

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

SERVICE_NOT_ALLOWEDFService not allowed

使用正确的信息重试,若问题依旧,联系万里汇技术支持以解决问题

CURRENCY_NOT_SUPPORTFThe currency is not supported.

暂不支持该币种

CONTRACT_CHECK_FAILFThe contract check has failed.

检查合约状态后重试

ACCESS_TOKEN_EXPIREDFThe access token expired.

刷新token接口以重新获取访问令牌(access token),或联系万里汇技术支持以解决问题

AUTHORIZATION_NOT_EXISTFThe authorization does not exist.

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

failReason.resultCode

结果码结果码信息行动建议
CURRENCY_NOT_SUPPORTFThe currency is not supported.

确认币种信息正确后重试。

CARD_INFO_NOT_MATCHFThe card information does not match.

换卡重试。

ORDER_IS_REVERSEDFThe order is reversed.

换单重试。

ORDER_IS_CLOSEDFThe order is closed.

换单重试。

AMOUNT_EXCEED_LIMITFThe amount exceeds the limit.

确认金额正确后重试。

RISK_REJECTFThe transfer is rejected for risk control reasons.

通知用户需要通过风控审核。

BALANCE_NOT_ENOUGHFBalance is not enough.

确认余额充足后重试。

@2024 WorldFirst