Artikkeli · r6-merchant-002
BTCPayn maksupyyntö ja sen perusteella muodostetut laskut
BTCPay Serverin Payment Request eli maksupyyntö voi koota sovitun saatavan yhteen jaettavaan näkymään. Se ei ole sama objekti kuin pyynnön perusteella luotu yksittäinen lasku. Seuraava perustuu 28.10.2026 luettuun, tiettyyn dokumentaatiocommitiin sidottuun ohjeeseen, ei testattuun asennukseen.[1]
Pyyntö ja lasku vanhenevat erikseen
Ohjeen mukaan asiakas voi maksaa pyynnön osissa ja pyynnön voimassaolo päättyy, kun se on maksettu kokonaan tai kauppiaan mahdollisesti asettamana vanhenemisaikana. Maksamista jatkettaessa pyynnön perusteella muodostetaan lasku.[1] Yksittäinen lasku puolestaan vahvistaa pyydetyn määrän ja vaihtokurssin rajoitetuksi ajaksi ja sillä on omat tila- ja seurantakäsitteensä.[2]
Älä oleta, että pyyntö on maksettavissa ikuisesti, että kaikkien sen laskujen voimassaolo päättyy samanaikaisesti tai että pyynnön vanheneminen ratkaisee jo syntyneen laskun käyttäytymisen. Lähteet eivät tässä osoita kaikkia näiden aikojen, jälkikäteismaksujen ja seurannan yhdistelmiä.[1], [2] Vanhentunut lasku ei myöskään osoita, ettei rahaa olisi lähetetty; vanheneminen ei itsessään peruuta todellista maksua. Ennen uutta maksupyyntöä tai toimitusta selvitä sekä pyynnön että kunkin asiaan liittyvän laskun tila ja taustalla oleva maksu.
Määrä, kurssi ja aiemmin luotu lasku
Maksupyyntöohje kuvaa maksujen käyttävän maksuhetken vaihtokurssia.[1] Myöhemmin luotavan laskun tarjous voi siksi poiketa aiemmasta arviosta; jo luodun yksittäisen laskun määrä ja kurssi taas vahvistetaan rajoitetuksi ajaksi laskuohjeen mukaan.[2] Tämä ei lupaa tiettyä kurssia, tarkkaa kurssin määrityshetkeä kaikissa tilanteissa tai samaa toimintaa kaikille valuuttapareille ja maksutavoille. Tarkista oman kokoonpanosi näyttämä tarjous ja sen voimassaolo.
Mitä kauppias määrittää?
Tallennetussa ohjeessa pyyntö luodaan polusta Requests > Create Requests. Se liitetään storeen, johon pitää olla yhdistetty lompakko. Ohje kuvaa otsikon, määrän, valuutan, valinnaisen vanhenemisajan, ilmoitussähköpostin, asiakastietojen pyynnön sekä memo-kentän ja liitteen.[1] Tämä on dokumentoitu esimerkki, ei tämän työn varmistama nykyisen käyttöliittymän polku. Tarkista oman palvelin- ja liitännäiskokoonpanosi ohjeet ja oikeudet.
Ohje neuvoo osamaksuja varten valitsemaan Allow payee to create invoices in their own denomination -asetuksen.[1] Varmista, mitä oma versio todella sallii, ja sovi asiakkaan kanssa maksuehdoista erikseen. Kuvitellussa palvelukaupassa kauppias voisi harkita yhtä pyyntöä ja erillisiä eriä; emme ole luoneet pyyntöä tai kokeilleet tätä maksupolkua.
Pyynnölle muodostuu jaettava URL, ja ohje kuvaa myös tulostuksen, Clone-toiminnon ja laskuluettelon Payment Request -merkinnän.[1] Ennen linkin jakamista tarkista oikea asiakas ja saatava; kopioinnin jälkeen tarkista vastaanottaja, määrä, viesti ja vanheneminen uudelleen. Linkki, viesti ja liitteet voivat paljastaa tietoja riippuen todellisista käyttöoikeuksista: lähde ei ratkaise, kuka ne voi nähdä tai kuinka kauan niitä säilytetään. Selvitä käyttöoikeudet, säilytys ja soveltuvat tietosuojavelvoitteet erikseen ja vältä tarpeettomia henkilötietoja.
Tilamerkintä ei yksin todista maksua
Pyyntöohjeen mukaan kokonaan maksettu pyyntö näytetään tilassa Settled, ja osasuorituksen jälkeen esitetään jäljellä oleva määrä.[1] Se ei yksin todista jokaisen taustalla olevan maksun selvitystä tai vahvistusta. Laskuohjeen mukaan Processing on täyteen maksettu lasku, jonka maksutavan selvitysehdot ovat kesken, ja Marked voi olla käyttäjän käsin asettama tila eikä todista lohkoketjuvahvistusta.[2] Se, muuttaako laskun käsin asetettu tila maksupyynnön tilaa, ei ole näistä lähteistä varmistettu; älä oleta vaikutusta kumpaankaan suuntaan.
Tunnista kukin asianomainen lasku ja taustalla oleva maksu, tarkista maksutapa, määrä, mahdolliset poikkeamat ja yrityksen maksutapakohtainen vahvistus- tai selvityskäytäntö. Lightningille ei pidä olettaa yleistä on-chain-vahvistusmäärää.[2] Poikkeavan laskun tai palautuksen selvittäminen kuuluu erilliseen nsn-001-oppaaseen ja maksun ja tilauksen ristiriidan selvittäminen nsn-002-oppaaseen, jos ne ovat käytettävissä.
Lähteet ovat eri varastojen ja commitien tallennettuja dokumentaatiokuvia eivätkä todista tietyn asennetun palvelinversion toimintaa.[1], [2] Tässä työssä ei avattu tiliä, muutettu asetuksia, luotu pyyntöä tai tehty maksuja. Testaus vaatii erillisen luvan ja eristetyn ympäristön ilman todellisia asiakasvaroja.