MT/MX 报文查询

GET
/openapi/v1/payments/message/mtmx

查询转账交易关联的 MT/MX SWIFT 报文原文。适用于合规审计和问题排查。

各场景下 messageContent 的内容示例见 Payment 产品指南。

鉴权

bearerAuth
header鉴权Bearer <令牌>

通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。

查询参数

paymentReference*string

来自转账结果的支付参考号。长度 20

direction*string

支付方向。长度 10

可选值"INCOMING""OUTGOING"

Header 参数

X-Channel-Provider*string

渠道提供商标识,如 GLDB

响应体

返回报文原文。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

请求追踪 ID。联系技术支持时请提供

data?

业务数据基类字段。所有业务响应的 data 对象中都包含这些字段(手续费预估除外)。

请求示例
curl -X GET 'https://api.test.stabofx.com/openapi/v1/payments/message/mtmx?paymentReference=SGL24241GG0LJHCB&direction=INCOMING' \  -H 'X-Channel-Provider: GLDB'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "a1b2c3d4-e5f6-7890",  "data": {    "providerStatusCode": "000000",    "providerMessage": "ok",    "providerRequestSerialNo": "795883203712778240",    "providerResponseSerialNo": "785957885476737024",    "providerTimestamp": "2023-05-17 21:03:48",    "messageContent": "{1:F01EXMPSGS0AXXX...}",    "transactionDateTime": "20241015085928261"  }}