开发者文档
官网控制台

跨境汇款

POST
/openapi/v1/payments/transfer/swift

通过 SWIFT 网络进行跨境汇款。注意：GLDB 渠道不支持 SGD 币种的跨境汇款。

注意事项（GLDB 渠道）

  • 不支持 SGD 币种
  • BIC 代码不足 11 位需补充 X
  • beneficiaryName、beneficiaryAddress、remarks 仅支持字母数字、空格及特殊字符 / - ? : ( ) . , ' +
  • 走 POBO 出账的订单，响应会返回 poboAccountNo / poboAccountName；调用结果查询接口时建议传入 accountNumber=poboAccountNo，以明确指定 POBO 出账账号。未传 accountNumber 时，系统将根据 referenceNo 自动匹配对应的 POBO 出账账号。

鉴权

bearerAuth
header鉴权Bearer <令牌>

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

Header 参数

X-Channel-Provider*string

渠道提供商标识，如 GLDB

Idempotency-Key*string

唯一请求标识，用于防止重复操作 (建议使用 UUID)。有效期 24 小时。每笔转账交易必须使用唯一的 Key，切勿为不同交易复用同一 Key。同一 Key 在有效期内再次提交会被拒绝，规则见 Payment 产品指南

请求体

application/json
  1. body
referenceNo*string

请求参考号，唯一请求标识。长度 32

fromAccount*string

付款方账号，付款账户。长度 32

fromAccountName?string

付款方名称。长度 128

beneficiaryAccount*string

收款方账号，收款账户。长度 32

beneficiaryName*string

收款人姓名。长度 65。仅支持字母数字、空格及特殊字符 / - ? : ( ) . , ' +

beneficiaryAddress*string

收款人地址。长度 70。仅支持字母数字、空格及特殊字符 / - ? : ( ) . , ' +

beneficiaryCountryCode*string

收款方国家代码，ISO 3166-1 Alpha-2。长度 10

beneficiaryCountryName*string

国家全称。长度 256

currency*string

币种，不支持 SGD。长度 3

amount*string

交易金额，最多 2 位小数。长度 16

beneficiaryBankCode*string

收款方银行 BIC 代码 (11 位)。长度 35

beneficiaryBankName?string

收款方银行名称。长度 45

chargeBearer*ChargeBearer

费用承担方式。

  • SHA: 费用各自承担
  • OUR: 汇款人承担全部费用
  • BEN: 收款人承担全部费用
可选值"SHA""OUR""BEN"
purposeCode*string

汇款目的，取值见汇款目的代码。长度 32

remarks?string

附言。长度 65。仅支持字母数字、空格及特殊字符 / - ? : ( ) . , ' +

intermediaryBankAddress?string

中间行地址。长度 256

intermediaryBankCode?string

中间行 BIC。长度 35

intermediaryBankName?string

中间行名称。长度 45

autoUsePobo?boolean

是否允许在付款账户为 VA 时，自动使用关联的 PoBo 账号出账

响应体

返回汇款受理结果。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

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

data?

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

请求示例
curl -X POST 'https://api.test.stabofx.com/openapi/v1/payments/transfer/swift' \  -H 'X-Channel-Provider: GLDB' \  -H 'Idempotency-Key: 7f3c2c0e-5b1a-4f6e-9d2a-0a1b2c3d4e5f' \  -H 'Content-Type: application/json' \  -d '{  "referenceNo": "STABO20231121003",  "fromAccount": "10000000001",  "beneficiaryAccount": "10000000005",  "beneficiaryName": "Example Company",  "beneficiaryAddress": "1 Example Road",  "beneficiaryCountryCode": "SG",  "beneficiaryCountryName": "Singapore",  "currency": "USD",  "amount": "1001.64",  "beneficiaryBankCode": "EXMPSGS0XXX",  "beneficiaryBankName": "EXAMPLE BANK LTD",  "chargeBearer": "SHA",  "purposeCode": "BEXP",  "remarks": "open transfer test"}'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "ba1b1f01-bfdf-460a-b0a8-b16766486cd5",  "data": {    "providerStatusCode": "000000",    "providerMessage": "ok",    "providerRequestSerialNo": "795883203712778240",    "providerResponseSerialNo": "785957885476737024",    "providerTimestamp": "2023-05-17 21:03:48",    "channelSerialNo": "12307270000085357",    "status": "SUCCESS",    "coreSerialNo": "PI232080W9YZ6CKR",    "estimatedFee": "50",    "estimatedFeeCurrency": "USD",    "poboAccountNo": "10000000003",    "poboAccountName": "EXAMPLE PTE. LTD."  }}