Fiatside
fr

Developers

참조 데이터 및 페이지 매김

지급 경로, 자산 및 국가 카탈로그는 사이트에 제공되는 것과 동일한 소스입니다. 여기에는 한도, 지연, 수수료 및 필드 스키마가 포함되어 있어 국가별로 코딩하는 대신 지급 양식을 생성할 수 있습니다.

새로 고침 빈도

이 데이터는 거의 변경되지 않지만 변경됩니다: 지급 경로 상한, 마감 시간, 국가 개설 등. 최소한 매일 새로 고치고 코드에 고정하지 마십시오. 각 항목에는 마지막 수동 확인 날짜가 있습니다: 지난 6개월이 지난 경우 확인이 필요합니다.

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는 BASE 단위로 표현됩니다 (20000000 = 소수점 6자리의 20 USDT). 이 임계값 미만에서는 네트워크 비용이 작업의 대부분을 차지합니다.

가능한 오류: 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."
  }
}

패턴 검증은 귀하 측과 당사 측 모두에서 수행됩니다: 귀하의 검증은 사용자의 왕복을 절약하고, 당사의 검증은 권위적입니다. 도움말 텍스트는 두 언어로 제공되며 표시할 가치가 있습니다: 거부된 지급의 대부분은 중단이 아닌 잘못 입력된 형식에서 발생하므로 이를 방지합니다.