开发者文档
官网控制台

跨境汇款结果查询

GET
/openapi/v1/payments/transfer/swift/{referenceNo}

查询跨境汇款的结果状态。

鉴权

bearerAuth
header鉴权Bearer <令牌>

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

路径参数

referenceNo*string

请求参考号，即发起转账时传入的 referenceNo

查询参数

accountNumber?string

付款账号。POBO 出账订单建议传入转账响应中的 poboAccountNo，以明确指定本次查询使用的 POBO 出账账号和证书；未传 accountNumber 时，系统将根据 referenceNo 自动匹配对应的 POBO 出账账号。普通订单可不传。长度 32

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/transfer/swift/STABO20231121001' \  -H 'X-Channel-Provider: GLDB'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "0861d563-26f6-47f6-8a34-8b1e00ff1eb9",  "data": {    "providerStatusCode": "000000",    "providerMessage": "ok",    "providerRequestSerialNo": "39158120641024781",    "providerResponseSerialNo": "1142949240058810368",    "providerTimestamp": "2025-12-30 14:20:20",    "channelSerialNo": "12512300000109360",    "paymentReference": "SGL25364MGLG0GHB",    "status": "SENT_TO_BANK",    "coreSerialNo": "PI253640MHJJ26T2",    "errorCode": null,    "errorMessage": null,    "estimatedFee": "40.00",    "estimatedFeeCurrency": "USD"  }}