开发者文档
官网控制台

查询转账预估手续费

POST
/openapi/v1/payments/fees/estimate

根据转账类型和金额，计算产生的预估手续费。

鉴权

bearerAuth
header鉴权Bearer <令牌>

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

Header 参数

X-Channel-Provider*string

渠道提供商标识，如 GLDB

请求体

application/json
  1. body
transferType*string

转账类型。

  • INTRA_BANK: 行内转账
  • MEPS: 本地转账 / MEPS+ 转账
  • SWIFT: 跨境汇款
可选值"INTRA_BANK""MEPS""SWIFT"
amount*string

转账金额。字符串格式的小数，必须大于 0

currency?string

转账币种。SWIFT 场景必填；INTRA_BANK、MEPS 不传时按 SGD 处理

usdEquivalentAmount?string

USD 等值金额。当且仅当 transferType=SWIFT 且 currency != SGD 时必填，用于计算费用上下限

chargeOption?ChargeBearer

费用承担方式。

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

响应体

返回预估手续费。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

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

data?
请求示例
curl -X POST 'https://api.test.stabofx.com/openapi/v1/payments/fees/estimate' \  -H 'X-Channel-Provider: GLDB' \  -H 'Content-Type: application/json' \  -d '{  "transferType": "SWIFT",  "amount": "100.00",  "currency": "USD",  "usdEquivalentAmount": "100.00",  "chargeOption": "SHA"}'
响应示例
{  "code": 200,  "message": "OK",  "traceId": "6a4b18f0fc0b17115026b6760490eec6",  "data": {    "fee": 20,    "currency": "SGD"  }}