Developers

Referenzdaten und Paginierung

Die Kataloge für Zahlungswege, Vermögenswerte und Länder sind dieselbe Quelle, die auch die Website speist. Sie enthalten Limits, Verzögerungen, Gebühren und Feldschemata – genug, um Ihr Auszahlungsformular zu generieren, anstatt es Land für Land zu programmieren.

Aktualisierungshäufigkeit

Diese Daten ändern sich selten, aber sie ändern sich: eine Obergrenze eines Zahlungswegs, ein Cut-off, eine Länderöffnung. Aktualisieren Sie sie mindestens täglich und frieren Sie sie nicht in Ihren Code ein. Jeder Eintrag trägt ein Datum der letzten manuellen Überprüfung: Nach sechs Monaten behandeln Sie ihn als überfällig für eine Prüfung.

Paginierung

Cursor-Paginierung, keine numerischen Offsets. Ein Offset überspringt oder dupliziert Elemente, sobald sich die Liste zwischen zwei Seiten bewegt; ein Cursor zeigt auf eine stabile Position.

Anfragehttp

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

Antwortjson

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

limit hat den Standardwert 50, Maximum 100. Ein größerer Wert wird auf das Maximum begrenzt, nicht abgelehnt.
next_cursor ist auf der letzten Seite null. Es ist das einzige Endsignal: Leiten Sie das Ende nicht aus einer kurzen Seite ab.
Ein Cursor ist undurchsichtig und hat keine garantierte Lebensdauer. Speichern Sie ihn nicht als dauerhafte Kennung und erstellen Sie keinen eigenen.
Die Reihenfolge ist innerhalb eines Paginierungslaufs stabil. Ein Element, das während des Blätterns hinzugefügt wird, erscheint in Ihrem nächsten vollständigen Lauf, nicht in der Mitte des aktuellen.

GET/api/v1/railsPublished contract, not open

Auszahlungsmethoden auflisten

Katalog der Auszahlungswege mit Währung, bedienten Ländern, p50- und p95-Verzögerungen, Regeln für Werktage, Annahmeschluss, Limits pro Vorgang in Untereinheiten, Gebühren und dem Schema der Begünstigtenfelder. Dieses Schema ermöglicht es Ihnen, das Auszahlungsformular zu generieren, anstatt es Land für Land zu programmieren.

Authentifizierung: Authorization: Bearer … Siehe Authentifizierung

Parameter

Parameter
Feld	Typ	Beschreibung
`country`	string	ISO-3166-1-alpha-2-Filter.
`currency`	string	ISO-4217-Filter.
`phase`	string	live, beta, geplant oder nie.
`limit`	integer	Seitengröße, 1 bis 100, Standard 50.
`cursor`	string	Undurchsichtiger Cursor, der vom vorherigen Aufruf zurückgegeben wurde.

Anfragebash

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

Antwort – veröffentlichter Vertragjson

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

Ein geschlossener Zahlungsweg wird mit seiner Phase und seinem Grund zurückgegeben, nicht aus der Liste entfernt. Eine Integration, die nicht erkennen kann, warum ein Zahlungsweg verschwunden ist, fragt ihren eigenen Support.

Mögliche Fehler: unauthorized, invalid_request. Vollständiger Katalog

GET/api/v1/assetsPublished contract, not open

Akzeptierte Vermögenswerte auflisten

Für die Einzahlung akzeptierte Vermögenswerte, mit Dezimalstellen der Basiseinheit, Netzwerken, Mindesteinzahlung, Dauer der Kursbindung und, falls relevant, dem Grund, warum ein Vermögenswert nicht angeboten wird.

Authentifizierung: Authorization: Bearer … Siehe Authentifizierung

Parameter

Parameter
Feld	Typ	Beschreibung
`network`	string	Gibt nur Vermögenswerte zurück, die in diesem Netzwerk verfügbar sind.

Anfragebash

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

Antwort – veröffentlichter Vertragjson

{
  "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 wird in BASISEINHEITEN ausgedrückt (20000000 = 20 USDT bei 6 Dezimalstellen). Unterhalb dieser Schwelle verbrauchen die Netzkosten den größten Teil des Vorgangs.

Mögliche Fehler: unauthorized. Vollständiger Katalog

GET/api/v1/countriesPublished contract, not open

Länder auflisten

Bediente Länder, Länder in Vorbereitung und abgelehnte Länder. Ein abgelehntes Land wird mit seinem Grund zurückgegeben: internationale Sanktionen, restriktive Maßnahmen oder ein unannehmbares Geldwäscherisiko.

Authentifizierung: Authorization: Bearer … Siehe Authentifizierung

Parameter

Parameter
Feld	Typ	Beschreibung
`status`	string	offen, in Kürze oder eingeschränkt.

Anfragebash

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

Antwort – veröffentlichter Vertragjson

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

Mögliche Fehler: unauthorized. Vollständiger Katalog

Das Feldschema des Empfängers

Jeder Zahlungsweg beschreibt die Felder, die er benötigt, mit ihrem Validierungsmuster, ihrer Normalisierung und ihrem Hilfetext. Dadurch können Sie ein korrektes Formular für ein Land generieren, das Sie nie integriert haben.

Ein Schemafeldjson

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

Die Mustervalidierung erfolgt auf Ihrer Seite UND auf unserer: Ihre spart dem Benutzer einen Roundtrip, unsere ist maßgeblich. Der Hilfetext wird in beiden Sprachen bereitgestellt und sollte angezeigt werden: Er verhindert die meisten abgelehnten Auszahlungen, die fast immer auf ein falsch eingegebenes Format zurückzuführen sind und nicht auf einen Ausfall.