Fiatside
fr

Developers

参照データとページネーション

送金経路、資産、国のカタログは、サイトに供給されるものと同じソースです。これらには、限度額、遅延、手数料、フィールドスキーマが含まれており、国ごとにコーディングする代わりに、送金フォームを生成するのに十分な情報を提供します。

更新頻度

このデータはめったに変更されませんが、変更されることはあります。送金経路の上限、締め切り、国の追加などです。少なくとも毎日更新し、コードに固定しないでください。各エントリには最終手動検証日が含まれています。過去6か月を超えた場合は、チェックが必要とみなされます。

01

ページネーション

数値オフセットではなく、カーソルページネーションを使用します。オフセットは、リストが2つのページ間で移動すると、項目をスキップまたは重複させます。カーソルは安定した位置を指します。

リクエストhttp
GET /api/v1/rails?limit=50&cursor=cJ0xNzg4MzU2OTgx
レスポンスjson
{
  "data": [ /* … */ ],
  "next_cursor": "cJ0xNzg4MzU3MTEy"
}
  • limitのデフォルトは50で、最大は100です。より大きい値は拒否されるのではなく、最大値にクランプされます。
  • next_cursorは最後のページではnullです。これが唯一の終了シグナルです。短いページから終了を推測しないでください。
  • カーソルは不透明で、保証された有効期間はありません。永続的な識別子として保存したり、自分で構築したりしないでください。
  • 順序は1回のページネーション実行内で安定しています。ページング中に追加された項目は、現在の実行の途中ではなく、次の完全な実行に表示されます。
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 = 6小数のUSDTで20）。このしきい値を下回ると、ネットワークコストが操作の大部分を消費します。

考えられるエラー: 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

受取人フィールドスキーマ

各送金経路は、必要なフィールドを、検証パターン、正規化、ヘルプテキストとともに記述します。これにより、統合したことのない国の正しいフォームを生成できます。

1つのスキーマフィールド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."
  }
}

パターン検証はお客様側と当社側の両方で行われます。お客様側ではユーザーの往復を節約し、当社側では権威があります。ヘルプテキストは両言語で提供され、表示する価値があります。これは、拒否された送金のほとんどが停止ではなく形式の誤入力によるものであるため、そのほとんどを防ぎます。