Developers

Referentiegegevens en paginering

De catalogi van netwerken, activa en landen zijn dezelfde bron die de site voedt. Ze bevatten limieten, vertragingen, kosten en veldschema's — genoeg om uw uitbetalingsformulier te genereren in plaats van het land voor land te coderen.

Verversingsfrequentie

Deze gegevens veranderen zelden, maar ze veranderen wel: een netwerklimiet, een cut-off, een land dat opengaat. Ververs ze minstens dagelijks en bevries ze niet in uw code. Elk item heeft een laatste handmatige verificatiedatum: als die ouder is dan zes maanden, behandel het dan als aan controle toe.

Paginering

Cursorpaginering, geen numerieke offsets. Een offset slaat items over of dupliceert ze zodra de lijst tussen twee pagina's beweegt; een cursor wijst naar een stabiele positie.

Verzoekhttp

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

Antwoordjson

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

limit is standaard 50, maximaal 100. Een grotere waarde wordt afgekapt tot het maximum, niet afgewezen.
next_cursor is null op de laatste pagina. Dat is het enige eindsignaal: leid het einde niet af uit een korte pagina.
Een cursor is ondoorzichtig en heeft geen gegarandeerde levensduur. Sla hem niet op als duurzame identificatie en bouw er zelf geen.
De volgorde is stabiel binnen één paginering. Een item dat wordt toegevoegd terwijl u aan het pagineren bent, verschijnt bij uw volgende volledige run, niet in het midden van de huidige.

GET/api/v1/railsPublished contract, not open

Uitbetalingsmethoden weergeven

Catalogus van uitbetalingsroutes met valuta, bediende landen, p50- en p95-vertragingen, regels voor werkdagen, cut-off, limieten per transactie in kleine eenheden, vergoedingen en het schema van het begunstigdeveld. Dat schema stelt u in staat om het uitbetalingsformulier te genereren in plaats van het land voor land te coderen.

Authenticatie: Authorization: Bearer … Zie authenticatie

Parameters

Parameters
Veld	Type	Beschrijving
`country`	string	ISO 3166-1 alpha-2 filter.
`currency`	string	ISO 4217 filter.
`phase`	string	live, beta, planned of never.
`limit`	integer	Paginagrootte, 1 tot 100, standaard 50.
`cursor`	string	Ondoorzichtige cursor geretourneerd door de vorige aanroep.

Verzoekbash

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

Antwoord — gepubliceerd contractjson

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

Een gesloten route wordt geretourneerd met zijn fase en reden, niet verwijderd uit de lijst. Een integratie die niet kan zien waarom een route is verdwenen, neemt contact op met zijn eigen ondersteuning.

Mogelijke fouten: unauthorized, invalid_request. Volledige catalogus

GET/api/v1/assetsPublished contract, not open

Geaccepteerde activa weergeven

Activa geaccepteerd voor storting, met decimalen van de basiseenheid, netwerken, minimumstorting, duur van de koersvaststelling en, waar relevant, de reden waarom een activum niet wordt aangeboden.

Authenticatie: Authorization: Bearer … Zie authenticatie

Parameters

Parameters
Veld	Type	Beschrijving
`network`	string	Retourneert alleen activa die beschikbaar zijn op dat netwerk.

Verzoekbash

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

Antwoord — gepubliceerd contractjson

{
  "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 wordt uitgedrukt in BASIS-eenheden (20000000 = 20 USDT bij 6 decimalen). Onder die drempel eet de netwerkkosten het grootste deel van de transactie op.

Mogelijke fouten: unauthorized. Volledige catalogus

GET/api/v1/countriesPublished contract, not open

Landen weergeven

Bediende landen, landen in voorbereiding en geweigerde landen. Een geweigerd land wordt geretourneerd met zijn reden: internationale sancties, beperkende maatregelen of een onaanvaardbaar risico op witwassen.

Authenticatie: Authorization: Bearer … Zie authenticatie

Parameters

Parameters
Veld	Type	Beschrijving
`status`	string	open, coming of restricted.

Verzoekbash

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

Antwoord — gepubliceerd contractjson

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

Mogelijke fouten: unauthorized. Volledige catalogus

Het veldschema voor begunstigden

Elk netwerk beschrijft de velden die het vereist, met hun validatiepatroon, normalisatie en helptekst. Daarmee kunt u een correct formulier genereren voor een land dat u nooit hebt geïntegreerd.

Een schemaveldjson

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

Patroonvalidatie gebeurt aan uw kant EN aan onze kant: de uwe bespaart de gebruiker een extra reis, de onze is gezaghebbend. De helptekst wordt in beide talen geleverd en verdient het om getoond te worden: het voorkomt de meeste afgewezen uitbetalingen, die bijna altijd komen door een verkeerd getypt formaat in plaats van een storing.