首页产品文档APISaaS平台
首页
产品文档
支付产品能力自动货币转换
API
接入准备支付服务退款服务Webhook 通知
SaaS平台
ShopifyWooCommerceShoplazzaSHOPYY
  • 支付产品能力
  • 自动货币转换
首页/产品/自动货币转换
StablePay 开发者文档
Home
Product
API
SaaS
Login
Register
GitHub
Home
Product
API
SaaS
Login
Register
GitHub
  • 产品介绍 / Product

    • 支付产品能力 / Payment Capabilities
    • 自动货币转换 / Auto Conversion

自动货币转换

当您的店铺使用非美元(USD)进行商品标价与展示时,StablePay 将在用户付款环节,自动根据实时汇率将该金额折算为美元(USD),并以等值的 USDT / USDC 完成收单与结算。

无论您的店铺前端显示的是什么币种,您最终收到的始终为:

USDT / USDC

此功能已默认开启,无需任何人工操作。


一、支持的标价币种范围

StablePay 当前支持以下主流跨境电商与独立站常用法币的自动换汇:

欧美地区

  • EUR(欧元)
  • GBP(英镑)
  • AUD(澳元)
  • CAD(加元)

亚太地区

  • JPY(日元)
  • HKD(港币)
  • SGD(新加坡元)

东南亚地区

  • IDR(印尼盾)
  • PHP(菲律宾比索)
  • VND(越南盾)
  • THB(泰铢)
  • MYR(马来西亚林吉特)

拉丁美洲

  • MXN(墨西哥比索)
  • BRL(巴西雷亚尔)

中东

  • AED(阿联酋迪拉姆)
  • SAR(沙特里亚尔)
  • QAR (卡塔尔里亚尔)
  • KWD (库拉迪纳尔)
  • OMR (阿曼里亚尔)
  • BHD (巴林迪纳尔)

提示

如您使用的币种在上述列表中,系统将自动完成换汇流程。


二、换汇与结算规则

工作流程

当您的店铺使用非美元币种标价时,系统会在支付时执行以下流程:

本地币种金额
    ↓
(按实时汇率)
    ↓
折算为 USD
    ↓
(1:1)
    ↓
以 USDT / USDC 完成付款与结算

核心规则

项目说明
汇率参考国际主流大型银行中间价
换汇费用无额外加价
结算方式USDT / USDC
结算周期不变(仍为 T+1)

三、收单费用说明

无论店铺使用哪种币种标价,所有收单手续费均以「美元(USD)」为基准计算,并在结算时正常扣除。

示例说明

假设您的商品标价为:100 EUR

支付流程:

100 EUR
  ↓
自动换汇为 108.50 USD
  ↓
用户实际支付:108.50 USDT / USDC
  ↓
按 108.50 USD 计算收单费用
  ↓
结算到账 = 108.50 - 手续费(以 USDT/USDC 发放)

您的收款资产:

  • USDT / USDC
  • 手续费按美元金额计算并扣除(逻辑完全透明)

费用计算示例

商品标价换汇汇率USD 等值手续费(1.5%)实际到账
100 EUR1.085108.50 USD1.63 USDT106.87 USDT
50 GBP1.2763.50 USD0.95 USDT62.55 USDT

注意

手续费始终按美元金额计算,与您的店铺标价币种无关。


四、开关说明(重要限制)

功能状态

目前该功能:

  • 默认开启
  • 暂不支持在后台关闭

如何避免自动换汇

如您不希望使用自动换汇功能,请在下单或 API 传参时将币种统一设为 USD:

方法一:店铺后台设置

后台设置 → 商品管理 → 商品币种 → 选择 USD

方法二:API 接口传参

// 创建支付会话时指定 USD
{
  "amount": {
    "value": "100",
    "currency": "USD"  // 使用 USD 避免换汇
  }
}

提示

当币种为 USD 时,系统不会触发换汇逻辑,直接 1:1 转换为 USDT/USDC。

When your store prices products in a currency other than USD, StablePay will automatically convert the amount to USD at real-time exchange rates during payment, completing the transaction and settlement in equivalent USDT/USDC.

Regardless of what currency your storefront displays, you will always receive:

USDT / USDC

This feature is enabled by default and requires no manual operation.


1. Supported Pricing Currencies

StablePay currently supports automatic currency conversion for the following major fiat currencies commonly used in cross-border e-commerce:

Europe & Americas

  • EUR (Euro)
  • GBP (British Pound)
  • AUD (Australian Dollar)
  • CAD (Canadian Dollar)

Asia Pacific

  • JPY (Japanese Yen)
  • HKD (Hong Kong Dollar)
  • SGD (Singapore Dollar)

Southeast Asia

  • IDR (Indonesian Rupiah)
  • PHP (Philippine Peso)
  • VND (Vietnamese Dong)
  • THB (Thai Baht)
  • MYR (Malaysian Ringgit)

Latin America

  • MXN (Mexican Peso)
  • BRL (Brazilian Real)

Middle East

  • AED (United Arab Emirates Dirham)
  • SAR (Saudi Riyal)
  • QAR (Qatari Riyal)
  • KWD (Kuwaiti Dinar)
  • OMR (Omani Rial)
  • BHD (Bahraini Dinar)

Note

If your currency is in the above list, the system will automatically complete the conversion process.


2. Conversion & Settlement Rules

Workflow

When your store prices in a non-USD currency, the system executes the following process during payment:

Local Currency Amount
    ↓
(At Real-time Rate)
    ↓
Convert to USD
    ↓
(1:1)
    ↓
Complete Payment & Settlement in USDT/USDC

Core Rules

ItemDescription
Exchange Rate ReferenceMajor international bank mid-rates
Conversion FeeNo additional markup
Settlement MethodUSDT / USDC
Settlement CycleUnchanged (still T+1)

3. Transaction Fee Details

Regardless of your store's pricing currency, all transaction fees are calculated based on USD and deducted during settlement.

Example

Assume your product is priced at: 100 EUR

Payment Flow:

100 EUR
  ↓
Auto-convert to 108.50 USD
  ↓
User pays: 108.50 USDT/USDC
  ↓
Transaction fee calculated on 108.50 USD
  ↓
Settlement = 108.50 - fee (paid in USDT/USDC)

Your Received Assets:

  • USDT / USDC
  • Fees calculated on USD amount and deducted (completely transparent)

Fee Calculation Examples

Product PriceExchange RateUSD EquivalentFee (1.5%)Net Settlement
100 EUR1.085108.50 USD1.63 USDT106.87 USDT
50 GBP1.2763.50 USD0.95 USDT62.55 USDT

Note

Fees are always calculated in USD, regardless of your store's pricing currency.


4. Feature Settings (Important Limitations)

Feature Status

Currently this feature:

  • Enabled by default
  • Cannot be disabled in dashboard

How to Avoid Auto-Conversion

If you don't want to use automatic currency conversion, set the currency to USD when placing orders or via API:

Method 1: Store Dashboard Settings

Dashboard → Product Management → Product Currency → Select USD

Method 2: API Parameters

// Specify USD when creating payment session
{
  "amount": {
    "value": "100",
    "currency": "USD"  // Use USD to avoid conversion
  }
}

Note

When the currency is USD, the system will not trigger conversion logic and will directly convert 1:1 to USDT/USDC.

最后更新 / Last Updated: 2026/3/5 10:40
Prev
支付产品能力 / Payment Capabilities