StablePay Docs
产品开发者联系我们
首页产品文档快速开始APISaaS平台
首页
产品文档
支付产品能力自动货币转换
快速开始
快速开始身份认证支付会话商户交易退款
API
API 参考版本控制身份认证请求与响应分页频率限制错误处理支付服务退款服务Webhook 通知
SaaS平台
ShopifyWooCommerceShoplazza 店匠
  • 支付产品能力
  • 自动货币转换
StablePay 开发者文档
Home
Product
Quick Start
API
SaaS
Login
Register
GitHub
Home
Product
Quick Start
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(巴西雷亚尔)

提示

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


二、换汇与结算规则

工作流程

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

本地币种金额
    ↓
(按实时汇率)
    ↓
折算为 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)

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: 2025/12/3 20:55
Prev
支付产品能力 / Payment Capabilities