BTCPay-lasku maksettiin osittain, liikaa tai myöhässä: mitä kauppias tarkistaa?

Tämä ohje on kauppiaalle, joka selvittää BTCPay Serverin tilauslaskun poikkeavaa suoritusta. Se ei ole yleinen kuvaus muiden maksupalveluiden tiloista. Dokumentaation esimerkkiä tai todellista palvelinta ei ole testattu; oman asennuksen versio, maksutavat, asetukset ja integraatio pitää varmistaa erikseen.

Aloita oikeasta laskusta

Etsi tilaukseen liittyvä lasku omasta valtuutetusta hallintanäkymästäsi. Vertaa tilauksen ja laskun yhteyttä, laskun maksutietoja sekä sitä, mitä asiakas kertoo. Säilytä selvityksessä vain tarpeelliset tiedot suojatusti; älä pyydä asiakkaalta palautuslausetta tai yksityisiä avaimia.

BTCPayn integraatio-opas neuvoo säilyttämään laskutunnisteen tilauksen yhteydessä. Laskun tilannekuvaa haettaessa opas kehottaa tarkistamaan sekä status- että additionalStatus-kentän: pelkkä päätila ei aina kerro koko kuvaa.[1] Jos et näe kenttiä käyttämässäsi näkymässä, pyydä integraation ylläpitäjää tarkistamaan ne valtuutetulla tavalla. Älä oleta, että nimet tai tilayhdistelmät ovat samat toisessa versiossa tai palvelussa.

Havaittu suoritus ei yksin todista maksun lopullisuutta: tarkista maksutapa, sen taustalla oleva maksutapahtuma ja kaupan selvitysehdot ennen toimitusta tai manuaalista tilamuutosta. Laskuohjeessa Processing odottaa vielä maksutavan selvitysehtoja; normaalissa, ei-manuaalisesti merkityssä tapauksessa Settled kuvaa niiden täyttyneen. Lasku voidaan kuitenkin merkitä manuaalisesti Settled-tilaan: Marked osoittaa manuaalisen merkinnän eikä todista lohkoketjuvahvistusta.[3] Tarkista myös additionalStatus, maksutapahtuma ja kaupan menettely; tulkitse Lightning ja muut maksutavat niiden omien selvitysehtojen mukaan. Älä oleta yleispätevää vahvistusmäärää.[3]

Erota kolme selvityskysymystä

Osasuoritus: vertaa laskun pyydettyä määrää ja kirjattuja maksutietoja. Oppaan luettelema lisätila PaidPartial liittyy osamaksutilanteeseen.[1][3] Älä päättele sen perusteella yksin, mitä tilaukselle pitää tehdä.
Liikasuoritus: vertaa pyydettyä ja kirjattua määrää sekä tarkista mahdollinen PaidOver-lisätila.[1][3] Selvitä mahdollinen erotus ja sen käsittely oman integraation ja kaupan menettelyn mukaan; lisätila ei itsessään takaa automaattista palautusta.
Myöhästynyt maksu: vertaa laskun vanhentumista ja maksutietoja sekä tarkista mahdollinen PaidLate-lisätila.[1][3] Laskuohje kuvaa Paid late -poikkeuksen täytenä maksuna, joka saapui vanhentumisen jälkeen; integraatio-opas huomauttaa, että vanhentuneeseen laskuun voi liittyä myös osittainen maksu.[1][3] Älä oleta, että myöhäinen osasuoritus välttämättä näkyy PaidLate-lisätilana, tai tulkitse Expired-päätilaa yksin todisteeksi siitä, ettei mitään ole maksettu.

Jos asiakas ilmoittaa maksaneensa mutta suoritusta ei saada yhdistettyä laskuun, turvallisuussuosituksena on verrata valtuutetusti tarkoitettua maksutapaa, kohdetta, määrää ja saatavilla olevia tapahtumatietoja. Laskuohje sanoo, että lompakon tapahtumat, joita ei maksettu laskun kautta, näkyvät lompakossa.[3] Se ei osoita, että kaikki väärään verkkoon tai kohteeseen lähetetyt tai muuten kohdistumattomat maksut näkyvät siellä. Laskumerkinnän puuttuminen ei yksin todista maksamattomuutta tai varojen palautettavuutta; löytymistä, yhteensopivuutta tai palautumista ei luvata.

Nämä kohdat ohjaavat selvitystä, eivät määritä kaikkia tilojen mahdollisia yhdistelmiä, maksutapakohtaisia poikkeuksia tai sitä, miten asiakas pitäisi hyvittää. Älä lähetä uutta maksupyyntöä tai käynnistä palautusta pelkän oletuksen perusteella. Selvitä tilanne asiakkaan kanssa turvallisen kanavan kautta ja käytä tarvittaessa asiantuntijan tai ylläpitäjän apua. Oikeudelliset velvoitteet eivät ratkea tällä teknisellä ohjeella.

Jos palautusta harkitaan, varmista luotetussa kanavassa palautusta pyytävän tahon oikeutus oikeasuhtaisella todentamisella sekä tarkista palautuksen saaja, maksutapa ja kohde ennen mitään toimenpidettä. Älä kerää henkilöllisyystodistuksia rutiininomaisesti tai tarpeettomia henkilötietoja; arvioi tietojen tarpeellisuus tapauskohtaisesti ja suojaa ne.[7] Menettely ja mahdolliset lakisääteiset velvoitteet vaativat tietosuoja- ja oikeudellisen arvion. Älä päättele palautuskohdetta pelkästä lähettäjän syöteosoitteesta: Bitcoinin kehittäjäopas käsittelee väärälle saajalle palauttamisen riskiä.[6] Älä pyydä palautuslausetta, yksityisiä avaimia tai kirjautumis- tai vahvistuskoodeja. BTCPayn laskuohjeen mukainen palautuspolku riippuu laskun kelpoisuudesta ja käytettävissä olevista menetelmistä: asiakkaan lunastuksen jälkeen syntyvä maksu tarkistetaan ja käsitellään, eikä automaattista palautusta taata.[3] Oikeus palautukseen, määrä ja kurssi eivät ratkea pelkän teknisen tilan perusteella.

Jos laskun tämänhetkinen tila vaikuttaa odotetulta, mutta verkkokaupan tilaus ei päivity, kyse on eri selvityksestä: katso opas nsn-002-c3, joka käsittelee ilmoituksen ja tilauksen välistä integraatiota.

Rajaus

Lähteinä ovat 17.10.2025 päivätyn integraatio-oppaan ja 29.9.2026 päivätyn laskuohjeen dokumentaatiomuutosten lukitut versiot; ne eivät todista minkään asennetun BTCPay-version toimintaa.[1][3] Lähde, käytössä oleva versio ja todelliset poikkeustilanteet on tarkistettava uudelleen; Suomen saatavuutta tai kuluttajaoikeutta ei ole selvitetty.