Fiatside
fr

Developers

参考数据和分页

支付通道、资产和国家的目录与网站使用的数据源相同。它们包含限额、延迟、费用和字段模式——足以生成您的付款表单，而无需逐个国家对代码进行硬编码。

刷新频率

这些数据很少变化，但确实会变化：通道限额、截止时间、国家开放。至少每天刷新一次，不要将其冻结在代码中。每条记录都带有最后人工核验日期：超过六个月，应视为需要检查。

01

分页

使用游标分页，而非数字偏移。当列表在两页之间移动时，偏移会跳过或重复项目；游标指向稳定位置。

请求http
GET /api/v1/rails?limit=50&cursor=cJ0xNzg4MzU2OTgx
响应json
{
  "data": [ /* … */ ],
  "next_cursor": "cJ0xNzg4MzU3MTEy"
}
  • limit 默认为 50，最大为 100。更大的值会被限制到最大值，而不是被拒绝。
  • next_cursor 在最后一页为 null。这是唯一的结束信号：不要因为页面短就推断结束。
  • 游标是不透明的，没有保证的生命周期。不要将其存储为持久标识符，也不要自己构建。
  • 在一次分页运行中排序是稳定的。在分页过程中添加的项目会出现在下一次完整运行中，而不是当前运行的中间。
GET/api/v1/railsPublished contract, not open

列出支付方式

支付通道目录，包含货币、服务国家、p50和p95延迟、工作日规则、截止时间、每笔操作限额（以最小单位计）、费用和受益人字段模式。该模式使您能够生成支付表单，而无需逐个国家编码。

身份验证： Authorization: Bearer … 参见身份验证

参数

参数
字段类型描述
countrystringISO 3166-1 alpha-2过滤器。
currencystringISO 4217过滤器。
phasestringlive、beta、planned或never。
limitinteger页面大小，1到100，默认50。
cursorstring上一次调用返回的不透明游标。
请求bash
curl -sS 'https://fiatside.com/api/v1/rails?country=BR' \
  -H 'Authorization: Bearer sk_live_...'
响应——已发布合约json
{
  "data": [
    {
      "id": "br_pix",
      "slug": "pix",
      "name": "PIX",
      "kind": "instant_bank",
      "currency": "BRL",
      "countries": ["BR"],
      "phase": "live",
      "settlement": { "p50Minutes": 1, "p95Minutes": 10, "businessDaysOnly": false },
      "limits": { "minMinor": 1000, "maxMinor": 5000000, "decimals": 2 },
      "fees": { "fixedMinor": 0, "bps": 0 },
      "fields": [
        { "name": "pixKeyType", "type": "select", "required": true },
        { "name": "pixKey", "type": "text", "required": true, "maxLength": 77 },
        { "name": "taxId", "type": "text", "required": true, "pattern": "^[0-9]{11}$" }
      ],
      "verifiedAt": "2026-09-02"
    }
  ],
  "next_cursor": null
}
  • 关闭的通道会返回其阶段和原因，而不是从列表中移除。无法看到通道消失原因的集成会询问自己的支持。

可能的错误： unauthorized, invalid_request. 完整目录

GET/api/v1/assetsPublished contract, not open

列出接受的资产

接受存入的资产，包含基础单位小数位数、网络、最低存入金额、汇率锁定持续时间以及（如相关）不提供该资产的原因。

身份验证： Authorization: Bearer … 参见身份验证

参数

参数
字段类型描述
networkstring仅返回该网络上可用的资产。
请求bash
curl -sS 'https://fiatside.com/api/v1/assets?network=tron' \
  -H 'Authorization: Bearer sk_live_...'
响应——已发布合约json
{
  "data": [
    {
      "id": "usdt",
      "ticker": "USDT",
      "name": "Tether",
      "decimals": 6,
      "networks": ["tron", "ethereum", "bsc", "solana", "polygon", "arbitrum"],
      "stablecoin": true,
      "quoteLockSeconds": 1800,
      "minDepositBase": "20000000",
      "phase": "live"
    }
  ],
  "next_cursor": null
}
  • minDepositBase以基础单位表示（20000000 = 20 USDT，6位小数）。低于该阈值，网络成本会消耗大部分操作。

可能的错误： unauthorized. 完整目录

GET/api/v1/countriesPublished contract, not open

列出国家

服务国家、准备中的国家和被拒绝的国家。被拒绝的国家会返回其原因：国际制裁、限制性措施或不可接受的洗钱风险。

身份验证： Authorization: Bearer … 参见身份验证

参数

参数
字段类型描述
statusstringopen、coming或restricted。
请求bash
curl -sS 'https://fiatside.com/api/v1/countries?status=open' \
  -H 'Authorization: Bearer sk_live_...'
响应——已发布合约json
{
  "data": [
    { "code": "BR", "name": "Brasil", "currency": "BRL", "status": "open", "rails": ["br_pix", "paypal", "wise", "swift"] },
    { "code": "IR", "name": "Iran",   "currency": null,  "status": "restricted", "reason": "international_sanctions" }
  ],
  "next_cursor": null
}

可能的错误： unauthorized. 完整目录

02

受益人字段模式

每个通道都描述其必填字段，包括验证模式、规范化和帮助文本。这使您可以为从未集成过的国家生成正确的表单。

一个模式字段json
{
  "name": "iban",
  "label": { "fr": "IBAN", "en": "IBAN" },
  "type": "iban",
  "required": true,
  "pattern": "^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$",
  "normalize": "upper",
  "help": {
    "fr": "Sans espaces. Nous verifions la cle de controle avant de valider la commande.",
    "en": "No spaces. We validate the checksum before confirming your order."
  }
}

模式验证在您方和我们都执行：您方验证可节省用户一次往返，我们的是权威。帮助文本以两种语言提供，值得显示：它可以防止大多数被拒绝的付款，这些付款几乎总是由于格式输入错误而非服务中断。