Johdanto

FeitPay on kauppiaille tarkoitettu, usean asiakasorganisaation (multi-tenant) maksuyhdyskäytävän rajapinta: verkkokaupoille, SaaS-tuotteille, API-liiketoiminnoille ja alustoille. Luot maksuaikomuksia (tai laskuja ja maksulinkkejä), ohjaat asiakkaat isännöityyn kassaan ja vastaanotat allekirjoitettuja webhookeja, kun maksu etenee tarkasti määritellyssä tilakoneessa. Taloustiimit täsmäyttävät tiedot käsittelijän todisteita, raportteja ja vain lisäyksiä sallivaa aikajanaa vasten.

Tilin aktivointi

Jokainen API-avain on live-avain ja jokainen maksu on todellinen. Live-maksut otetaan käyttöön, kun tilisi on vahvistettu ja hyväksytty: rekisteröidyt, määrität organisaatiosi ja lähetät yrityksesi tunnistamistiedot, FeitPay tarkastaa ne, ja live-API-avaimet, maksut ja nostot tulevat käytettäviksi, kun tilisi on aktivoitu.

Aktivoinnista päättää FeitPay. Hyväksytyn yrityksen tunnistamisen lisäksi se riippuu alustan omista julkaisuvaatimuksista, mukaan lukien Sääntelytilanne-sivulla kuvatut luvat, joten hyväksytty tunnistaminen ei yksinään aktivoi tiliä.

Ominaisuus	Tila
Rekisteröityminen, sähköpostin vahvistus, organisaatiot, kaupat, tiimikutsut	Saatavilla
Yrityksen tunnistaminen (KYB-kauppiashakemus)	Saatavilla — FeitPayn ylläpitäjät tarkastavat sen käsin; lähettäminen ei ole hyväksyntä
Tukipyynnöt	Saatavilla
Webhook-päätepisteet	Voidaan rekisteröidä. Päätepisteet kuuluvat yhteen ympäristöön, ja live-tapahtumat toimitetaan vain live-päätepisteisiin, joten rekisteröi omasi, kun tilisi on aktivoitu
Live-API-avaimet (gp_live_…)	Saatavilla, kun tilisi on aktivoitu; sitä ennen ne torjutaan koodilla live_keys_disabled
Maksuaikomukset, isännöity kassa, laskut ja maksulinkit	Kun tilisi on aktivoitu
Säilytyksessä olevat saldot ja nostot	Kun tilisi on aktivoitu; nostot otetaan käyttöön erikseen
PIX, kortit, SEPA	Ei saatavilla — edellyttää toimiluvan omaavia kumppaneita; kenenkään kanssa ei ole sopimusta

Kunnes tilisi on aktivoitu, live-ominaisuuksia koskevat pyynnöt epäonnistuvat virheellä feature_unavailable_error; katso Virheet.

Säilytys

Live-maksut ovat säilyttäviä (custodial). Ne käsitellään alustan omalla Bitcart-tilillä:

• asiakas maksaa alustan Bitcart-kaupan lompakkoon, ei sinun lompakkoosi; kassa avaa yhden Bitcart-laskun maksuaikomusta kohden, ja vain Bitcart-tila complete tekee aikomuksesta confirmed;
• vastaanotettu summa hyvitetään sen jälkeen organisaatiosi säilytyksessä olevaan saldoon: FeitPay säilyttää varoja alustan lompakoissa puolestasi ja kirjaa sinulle velkaa olevan summan vain lisäyksiä sallivaan kirjanpitoon (GET /v1/balances). Osittaiset tai myöhästyneet maksut hyvitetään vasta, kun ylläpitäjä on todentanut ne;
• nostat varat nostoina sallittujen osoitteiden luettelossa oleviin osoitteisiin samana varana (ei muuntoa). Oletuksena organisaatiosi toinen jäsen hyväksyy jokaisen noston, FeitPayn ylläpitäjä tarkastaa sen aina, ja Bitcart lähettää sen alustan kuumasta lompakosta.

Tilit aktivoidaan live-maksuille vasta, kun kaksi ylläpitäjää on hyväksynyt jokaisen julkaisuehdon (release gate) — myös oikeudellisen ehdon custody_authorisation, koska asiakkaiden kryptovarojen säilyttäminen ja siirtäminen on useimmilla lainkäyttöalueilla säänneltyä toimintaa. FeitPay ei ole saanut tällaista lupaa eikä väitä saaneensa.

Lisäksi:

• Alustan palvelumaksut laskutetaan kauppiaalta erikseen (kuukausilasku tai tilaus). Niitä ei koskaan vähennetä huomaamatta asiakkaiden maksuista.
• Saapuvien maksujen verkkomaksut maksaa lähettäjä, eivätkä ne sisälly maksettavaan summaan.
• Korttimaksujen kaltaista takaisinperintää (chargeback) ei ole. Palautukset eivät koskaan ole automaattisia: palautat varat itse, esimerkiksi nostona sallittuun osoitteeseen, jonka asiakas antaa sinulle.

Säilytys ei itsessään ole poikkeus sääntelystä — päinvastoin. Katso Sääntelytilanne.

Miten osat sopivat yhteen

1. Palvelimesi luo maksuaikomuksen live-API-avaimella ja Idempotency-Key-otsakkeella.
2. Asiakas avaa isännöidyn kassan URL-osoitteen (arvaamaton, lyhytikäinen käyttöoikeus-URL — avaimia ei tarvita). Kassa avaa laskun alustan Bitcart-tilillä ja näyttää jokaiselle hyväksytylle varalle osoitteen ja tarkan lähetettävän summan.
3. Käsittelijä ilmoittaa laskun tilan. FeitPay ei koskaan luota takaisinkutsun (callback) runkoon: se hakee laskun uudelleen Bitcartista, kuvaa sen tilan keskitettyyn tilakoneeseen ja, kun lasku on valmis, hyvittää vastaanotetun summan säilytyksessä olevaan saldoosi.
4. Webhookit ilmoittavat päätepisteellesi; toimitat tilauksen vain, kun aikomus on fulfillable, ja tarkistat sen GET-pyynnöllä ennen jokaista peruuttamatonta toimenpidettä.
5. Täsmäytys vertaa käsittelijän todisteita, odotettuja summia, hyvityksiä, nostoja ja webhook-toimituksia ja tuo poikkeamat esiin.

Kaikkialla toistuvat käytännöt

• Rajapinta on osoitteessa https://api.feitpay.com/v1, hallintapaneeli osoitteessa https://app.feitpay.com ja isännöidyt kassat osoitteessa https://checkout.feitpay.com.
• JSON, jonka kentät ovat snake_case-muodossa; aikaleimat ovat UTC-aikaa ISO-8601-muodossa (2026-10-20T12:00:00Z).
• Summat ovat desimaalimerkkijonoja ("59.90"), eivät koskaan liukulukuja. Kryptosummilla on lisäksi kokonaislukumerkkijono *_base_units ("99834" satoshia).
• Tunnisteet ovat läpinäkymättömiä, etuliitteellisiä merkkijonoja: pi_ maksuaikomukset, cs_ kassaistunnot, inv_ laskut, whe_ webhook-päätepisteet, evt_ tapahtumat, req_ pyyntötunnisteet.
• Jokaisessa vastauksessa on Request-Id-otsake. Mainitse se, kun otat yhteyttä tukeen.
• Jokaisella kauppiasobjektilla on kenttä livemode. Tämän alustan maksut ovat aina live-maksuja (livemode: true).