Developers

Referans verileri ve sayfalama

Kanal, varlık ve ülke katalogları siteyi besleyen kaynağın aynısıdır. Limitleri, gecikmeleri, ücretleri ve alan şemalarını taşırlar — ödeme formunuzu ülke ülke kodlamak yerine oluşturmak için yeterlidir.

Yenileme sıklığı

Bu veriler nadiren değişir, ancak değişir: bir kanal limiti, bir kesme zamanı, bir ülke açılışı. En az günlük yenileyin ve kodunuza dondurmayın. Her kayıt son manuel doğrulama tarihini taşır: altı ayı geçtiyse, kontrol zamanı gelmiş sayın.

Sayfalama

Sayısal ofsetler değil, imleç sayfalaması. Bir ofset, liste iki sayfa arasında hareket ettiğinde öğeleri atlar veya çoğaltır; bir imleç sabit bir konuma işaret eder.

İstekhttp

GET /api/v1/rails?limit=50&cursor=cJ0xNzg4MzU2OTgx

Yanıtjson

{
  "data": [ /* … */ ],
  "next_cursor": "cJ0xNzg4MzU3MTEy"
}

limit varsayılan olarak 50'dir, maksimum 100'dür. Daha büyük bir değer reddedilmek yerine maksimuma kırpılır.
next_cursor son sayfada null'dur. Tek bitiş sinyali budur: sonu kısa bir sayfadan çıkarmayın.
Bir imleç opaktır ve garantili bir ömrü yoktur. Kalıcı bir tanımlayıcı olarak saklamayın ve kendiniz bir tane oluşturmayın.
Sıralama tek bir sayfalama çalışması içinde sabittir. Sayfalama yaparken eklenen bir öğe, mevcut çalışmanın ortasında değil, bir sonraki tam çalışmanızda görünür.

GET/api/v1/railsPublished contract, not open

Ödeme yöntemlerini listele

Para birimi, hizmet verilen ülkeler, p50 ve p95 gecikmeleri, iş günü kuralları, kesim saati, alt birimlerde işlem başına limitler, ücretler ve lehdar alan şeması ile ödeme kanalı kataloğu. Bu şema, ödeme formunu ülke ülke kodlamak yerine oluşturmanızı sağlar.

Kimlik doğrulama: Authorization: Bearer … Kimlik doğrulamaya bakın

Parametreler

Parametreler
Alan	Tür	Açıklama
`country`	string	ISO 3166-1 alpha-2 filtresi.
`currency`	string	ISO 4217 filtresi.
`phase`	string	live, beta, planned veya never.
`limit`	integer	Sayfa boyutu, 1 ile 100 arası, varsayılan 50.
`cursor`	string	Önceki çağrı tarafından döndürülen opak imleç.

İstekbash

curl -sS 'https://fiatside.com/api/v1/rails?country=BR' \
  -H 'Authorization: Bearer sk_live_...'

Yanıt — yayınlanan sözleşmejson

{
  "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
}

Kapalı bir kanal, listeden çıkarılmak yerine aşaması ve nedeniyle döndürülür. Bir kanalın neden kaybolduğunu göremeyen bir entegrasyon, kendi destek birimine sorar.

Olası hatalar: unauthorized, invalid_request. Tam katalog

GET/api/v1/assetsPublished contract, not open

Kabul edilen varlıkları listele

Yatırma için kabul edilen varlıklar, temel birim ondalıkları, ağlar, minimum yatırma, kur kilitleme süresi ve ilgili olduğunda bir varlığın neden sunulmadığı ile birlikte.

Kimlik doğrulama: Authorization: Bearer … Kimlik doğrulamaya bakın

Parametreler

Parametreler
Alan	Tür	Açıklama
`network`	string	Yalnızca o ağda mevcut olan varlıkları döndürür.

İstekbash

curl -sS 'https://fiatside.com/api/v1/assets?network=tron' \
  -H 'Authorization: Bearer sk_live_...'

Yanıt — yayınlanan sözleşmejson

{
  "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, TEMEL birimlerle ifade edilir (20000000 = 6 ondalıklı 20 USDT). Bu eşiğin altında ağ maliyeti işlemin çoğunu tüketir.

Olası hatalar: unauthorized. Tam katalog

GET/api/v1/countriesPublished contract, not open

Ülkeleri listele

Hizmet verilen ülkeler, hazırlık aşamasındaki ülkeler ve reddedilen ülkeler. Reddedilen bir ülke, nedeniyle birlikte döndürülür: uluslararası yaptırımlar, kısıtlayıcı önlemler veya kabul edilemez bir kara para aklama riski.

Kimlik doğrulama: Authorization: Bearer … Kimlik doğrulamaya bakın

Parametreler

Parametreler
Alan	Tür	Açıklama
`status`	string	open, coming veya restricted.

İstekbash

curl -sS 'https://fiatside.com/api/v1/countries?status=open' \
  -H 'Authorization: Bearer sk_live_...'

Yanıt — yayınlanan sözleşmejson

{
  "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
}

Olası hatalar: unauthorized. Tam katalog

Alıcı alan şeması

Her kanal, doğrulama deseni, normalizasyonu ve yardım metniyle birlikte gerektirdiği alanları tanımlar. Bu, daha önce hiç entegre etmediğiniz bir ülke için doğru bir form oluşturmanızı sağlar.

Bir şema alanı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."
  }
}

Desen doğrulaması hem sizin tarafınızda hem de bizim tarafımızda gerçekleşir: sizinki kullanıcıya bir gidiş-dönüş kazandırır, bizimki yetkilidir. Yardım metni her iki dilde sağlanır ve görüntülenmeyi hak eder: çoğu reddedilen ödemeyi önler; bunlar neredeyse her zaman bir kesintiden değil, yanlış yazılmış bir formattan kaynaklanır.