Muutosloki ja versiointi

Versiointikäytäntö

• API-versio on päivämäärä. Nykyinen versio on 2026-10-01, ja se ilmoitetaan jokaisessa webhookissa kentässä api_version.
• Poluissa on vakaa pääversion etuliite (/v1). /v1:n sisällä:
  • Lisäävät muutokset voidaan julkaista milloin tahansa: uudet päätepisteet, uudet valinnaiset pyyntökentät, uudet vastauskentät, uudet tapahtumatyypit, uudet virheiden code-arvot. Kirjoita asiakasohjelmat niin, että ne ohittavat tuntemattomat kentät ja käsittelevät tuntemattomat koodit niiden type-arvon mukaan.
  • Rikkovat muutokset (kenttien poistaminen tai uudelleennimeäminen, tyyppien tai merkityksen muuttaminen) julkaistaan vain uudessa päivätyssä versiossa, joka ilmoitetaan tässä muutoslokissa etukäteen, ja edellinen versio pidetään saatavilla dokumentoidun ajan.
• Webhookien sisällöt noudattavat samoja sääntöjä. Sido käsittelysi kenttiin event_type ja api_version.
• SDK:t noudattavat semanttista versiointia ja ilmoittavat, minkä API-version mukaan ne on luotu.

2026-10-21 — vain live-tilassa toimiva alusta ja säilyttävät live-maksut

Alusta toimii nyt vain live-tilassa: jokainen API-avain on live-avain ja jokainen maksu on todellinen. Testi-API-avaimet, testiverkot, lohkoketjusimulaattori ja julkinen demokassa poistettiin. Rekisteröityminen, organisaatiot, kaupat, tiimikutsut, yrityksen tunnistaminen ja tukipyynnöt ovat jokaisen tilin käytettävissä; live-API-avaimet, maksuaikomukset, kassaistunnot ja nostot ovat käytettävissä, kun tilisi on aktivoitu, ja sitä ennen ne torjutaan virheellä feature_unavailable_error.

• GET /v1/health saa kentän test_mode_enabled (tällä alustalla aina false) sekä uuden environment-arvon.
• Uusi virhekoodi test_mode_disabled avaimille ja maksuille, jotka eivät ole live-tilassa.

Live-maksut ovat säilyttäviä: ne käsitellään alustan Bitcart-tilillä, ja FeitPay säilyttää varat saldonasi, kunnes nostat ne hyväksytyillä nostoilla. Tilit aktivoidaan live-maksuille vasta, kun jokainen julkaisuehto (release gate) on hyväksytty, mukaan lukien uusi oikeudellinen ehto säilytys- ja siirtoluvasta. Lisäävät API-muutokset:

• Saldot ja nostot: GET /v1/balances, GET /v1/payout-assets, GET /v1/payout-destinations, GET ja POST /v1/payouts, GET /v1/payouts/{payout_id} sekä POST /v1/payouts/{payout_id}/cancel. Nostojen hyväksyminen ja nosto-osoitteiden hallinta ovat hallintapaneelin toimintoja.
• POST /v1/public/checkout-sessions/{id}/processor-invoice Bitcartin kautta käsiteltäville live-kassoille sekä null-arvon salliva processor-objekti maksuaikomuksissa ja julkisissa kassaistunnoissa.
• Webhookit payout.requested, payout.approved, payout.rejected, payout.canceled, payout.sent, payout.completed ja payout.failed.
• API-avainten käyttöoikeudet balances:read, payouts:read ja payouts:write; poikkeamatyypit custody_uncredited ja payout_attention.
• Virhekoodit live_processing_unavailable, allowed_networks_unsupported (live-maksut tarjoavat kaikki alustan hyväksymät varat), payouts_live_only ja payouts_unavailable.

2026-10-01 — ensimmäinen API-versio

• Maksuaikomukset, isännöidyt kassaistunnot, laskut ja maksulinkit.
• Muuttumattomat hintatarjoukset ceil_to_asset_base_unit-pyöristyssäännöllä.
• Pelkkään seurantaan perustuvat (xpub) lompakot, aikomuskohtainen osoitteiden johtaminen ja omistajuustodisteet.
• Keskitetty tilakone, joka käsittelee tilat underpaid, overpaid, late_payment, reorged ja manual_review.
• Allekirjoitetut webhookit (HMAC-SHA256, salaisuuden vaihto kahdella allekirjoituksella), uudelleenyritykset viiveellä, epäonnistuneet toimitukset (dead letters) ja manuaalinen uudelleenyritys.
• Täsmäytyspoikkeamat, maksuraportit (CSV/JSON), laskutuksen käyttötiedot ja auditointiloki.
• SDK:t: TypeScript, React-apuvälineet, webhook-todentaja, Python ja Go.