Siirry sisältöön

Verkot ja varat

Verkot ja varat tulevat palvelinpuolen ominaisuusrekisteristä (capability registry), joka on julkisesti saatavilla:

  • GET /v1/networks ja GET /v1/assets — jokainen yhdyskäytävän tuntema verkko ja vara tiloineen
  • GET /v1/capabilities — verkot, varat ja maksutavat yhdessä vastauksessa

Lue rekisteri ajonaikaisesti; älä kovakoodaa sitä. Rekisteri on määräävä, ja rajapinta torjuu kaiken, mikä ei ole käytettävissä ympäristössäsi. Tällä alustalla voi käyttää vain merkintöjä, joilla on environment: "live" ja tila enabled (tai beta); merkintöjä, joilla on environment: "test", ei voi käyttää täällä maksuihin.

FeitPay ottaa live-verkot ja -varat käyttöön rekisterissä; merkintä, jota ei voi käyttää, näkyy tilassa disabled. Live-maksut otetaan käyttöön, kun tilisi on vahvistettu ja hyväksytty, eikä mitään näissä ohjeissa pidä tulkita lupaukseksi siitä, että jotakin tiettyä verkkoa tai varaa tarjottaisiin.

Live-maksut käsitellään alustan Bitcart-tilillä, joka tarjoaa kaikki alustan hyväksymät varat. Näet kunkin maksun tarjolla olevat varat:

  • kassaistunnon processor.methods — yksi merkintä kutakin hyväksyttyä varaa kohden: varan avain (kolikon symboli sekä tokeneilla ketju), ketju, tarkka summa, Bitcartin käyttämä vaihtokurssi ja maksuosoite;
  • GET /v1/payout-assets — varat, joita alustan lompakoissa on ja jotka ovat myös ne varat, joita voit nostaa.

Varoja ei voi rajata maksuaikomuskohtaisesti: allowed_networks torjutaan live-maksuissa (allowed_networks_unsupported).

Live-maksuissa Bitcart päättää omalla vahvistuskäytännöllään, milloin maksu on lopullinen: vain sen laskun tila complete tekee aikomuksesta confirmed, ja FeitPay kirjaa tämän tilan käsittelijän todisteeksi — ei koskaan omaksi lohkoketjuhavainnokseen.

Pelkkään seurantaan perustuvassa käsittelyssä (ei-säilyttävä tila, jota kuvataan sivulla Lompakot ja jota tämä alusta ei käytä maksuihin) jokaisella rekisterin verkolla on vahvistuskäytäntö (oletus ja valinnaiset summaan perustuvat portaat); maksuun sovellettava määrä jäädytetään sen tarjoukseen kenttään required_confirmations. Yhdyskäytävä laskee vahvistukset havaitsemansa ketjun kärjen perusteella — yksittäistä vahvistamatonta palveluntarjoajan vastausta ei koskaan pidetä lopullisena.

Pelkkään seurantaan perustuvassa käsittelyssä token-maksu hyvitetään vain, kun kaikki seuraavat vastaavat tarjotun varan rekisterimerkintää:

  1. verkko (ketjun tunniste),
  2. sopimusosoite (kanoninen muoto),
  3. desimaalit (rekisteristä — ei koskaan siirrosta tai seurantapalvelusta).

Tokenit, joissa on siirtomaksu (fee-on-transfer), uudelleenperustus (rebasing) tai muuten epätavallinen toiminta, hylätään, ellei niitä erikseen tueta. Symbolit ja nimet ovat vain näyttöä varten, eikä niitä koskaan käytetä vastaavuuden tarkistamiseen.

EVM-verkoissa asiakas maksaa gas-maksun natiivikolikossa maksettavan summan lisäksi. Live-maksut päätyvät alustan Bitcart-lompakoihin, ja noston verkkomaksun maksaa alustan kuuma lompakko.