Solana Pay on standardiprotokolla ja joukko referenssitoteutuksia, jotka mahdollistavat kehittäjille hajautettujen maksujen integroinnin sovelluksiinsa ja palveluihinsa. Se tarjoaa yhtenäisen lähestymistavan maksuihin koko Solana- ekosysteemissä varmistaen yhteensopivuuden lompakoiden, sovellusten ja palvelujen välillä.
Protokollan yleiskatsaus
Solana Pay määrittelee kaksi pääasiallista maksupyyntötyyppiä:
Siirtopyynnöt (Ei-interaktiiviset)
Siirtopyynnöt kuvaavat yksinkertaisia SOL- tai SPL-token-siirtoja käyttäen URL- parametreja. Lompakko voi suoraan koostaa ja allekirjoittaa tapahtuman ilman lisäviestintää palvelimen kanssa.
solana:recipient?amount=1.5&spl-token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
Käyttötapaukset:
- Yksinkertaiset maksut ja lahjoitukset
- QR-koodimaksut myyntipisteessä
- Maksulinkit sähköposteissa tai viesteissä
- Mobiilisovelluksen syvälinkit
Tapahtumapyynnöt (Interaktiiviset)
Tapahtumapyynnöt mahdollistavat monimutkaiset vuorovaikutukset sallimalla lompakon viestivän palvelimen kanssa minkä tahansa Solana-tapahtuman koostamiseksi. Tämä avaa edistyneitä käyttötapauksia pelkkien siirtojen lisäksi.
solana:https://merchant.com/api/payment
Käyttötapaukset:
- NFT-minttaus myyntipisteessä
- Dynaaminen hinnoittelu ja alennukset
- Monivaiheinen DeFi-tapahtumat
- Kanta-asiakasohjelman integrointi
- Räätälöity liiketoimintalogiikka
Keskeiset edut
Kehittäjille
- Standardiprotokolla: Yksi toteutus toimii kaikissa Solana-lompakoissa
- Kehyksestä riippumaton: Käytettävissä minkä tahansa web-kehyksen tai mobiilialustan kanssa
- Tyyppiturvallinen: Täysi TypeScript-tuki JavaScript SDK:ssa
- Joustava: Yksinkertaisista siirroista monimutkaisiin moni-instruktio-tapahtumiin
Käyttäjille
- Nopea: Tapahtumat vahvistuvat alle sekunnissa
- Edullinen: Keskimääräinen kustannus 0,0005 $ tapahtumaa kohti
- Turvallinen: Ei välittäjiä tai kolmannen osapuolen prosessoreita
- Yleiskäyttöinen: Toimii minkä tahansa Solana-lompakon kanssa
Kauppiaille
- Ei maksuja: Suorat maksut ilman käsittelymaksuja
- Reaaliaikainen: Välitön selvitys ja vahvistus
- Maailmanlaajuinen: Vastaanota maksuja mistä päin maailmaa tahansa
- Yhdisteltävä: Integroituu DeFi-protokollien ja NFT-markkinapaikkojen kanssa
Tekninen arkkitehtuuri
URL-rakenne
Solana Pay käyttää mukautettua solana:-URL-rakennetta, joka toimii
verkkoselaimissa ja mobiililaitteen käyttöjärjestelmissä:
- Verkko: URL-osoitteita voidaan käyttää linkkeinä tai koodata QR-koodeiksi
- Mobiili: Syvälinkkiintegraatio lompakkosovelluksiin
- Työpöytä: Protokollakäsittelijät saumattomaan lompakon käynnistämiseen
JavaScript SDK
@solana/pay SDK (rakennettu @solana/kit:n päälle) tarjoaa:
- Asiakastehtaat:
createMerchantClient,createWalletClient,createSolanaPayClientyhdisteltäville maksuvirroille - URL-koodaus/-jäsentäminen:
encodeURL,parseURLSolana Pay -URL-osoitteille - Siirtojen luominen:
createTransferSOL- ja SPL-token-maksuohjeita varten - Maksun vahvistaminen:
findReference,validateTransfer,watchReferencemaksujen havaitsemiseen ja vahvistamiseen - QR-koodit: Sisäänrakennettu
createQRskannattavien maksukoodien luomiseen - Kit-liitännäiset:
solanaPayMerchant(),solanaPayWallet()yhdistämiseen muiden@solana/kit-liitännäisten kanssa
Lompakon integraatio
Tuetut lompakot toteuttavat:
- URL-rakenteen käsittelyn ja jäsentämisen
- Tapahtuman koostamisen ja vahvistamisen
- Käyttäjän vahvistusvirrat
- Tapahtuman lähettämisen ja seurannan
Maksuvirran esimerkit
Verkkosovelluksesta mobiililompakkoon
- Verkkosovellus luo QR-koodin Solana Pay -URL-osoitteella
- Käyttäjä skannaa QR-koodin lompakkosovelluksella
- Lompakko jäsentää URL-osoitteen ja näyttää maksutiedot
- Käyttäjä vahvistaa maksun lompakossa
- Lompakko allekirjoittaa ja lähettää tapahtuman
- Verkkosovellus havaitsee maksuvahvistuksen
Verkkosovelluksesta selaimen lompakkoon
- Verkkosovellus näyttää "Maksa Solanalla" -painikkeen
- Käyttäjä napsauttaa painiketta käynnistääkseen lompakon
- Lompakon laajennus näyttää maksuvahvistuksen
- Käyttäjä hyväksyy tapahtuman
- Tapahtuma allekirjoitetaan ja lähetetään
- Verkkosovellus vastaanottaa maksuvahvistuksen
Mobiilisovelluksesta mobiililompakkoon
- Mobiilisovellus luo maksun syvälinkin
- Syvälinkki käynnistää lompakkosovelluksen
- Lompakko näyttää maksuvahvistuksen
- Käyttäjä hyväksyy tai hylkää maksun
- Lompakko palaa alkuperäiseen sovellukseen
- Sovellus vastaanottaa maksutuloksen
Turvallisuusnäkökohdat
Kauppiaille
- Vahvista transaktiot: Tarkista aina transaktiotiedot lohkoketjusta
- Käytä viitteitä: Sisällytä yksilölliset viiteavaimet maksujen tunnistamiseen
- Palvelinpuolen validointi: Laske summat ja vahvista maksut palvelinpuolella
- Nopeusrajoitukset: Ota käyttöön asianmukaiset nopeusrajoitukset maksupäätepisteille
Lompakkokehittäjille
- URL-validointi: Vahvista ja puhdista kaikki URL-komponentit
- Käyttäjävahvistus: Näytä aina selkeät maksutiedot käyttäjille
- Transaktiovalidointi: Tarkista transaktioiden sisältö ennen allekirjoitusta
- Vain HTTPS: Salli vain HTTPS-URL:t transaktiopyynnöille
Integraatiomallit
Verkkokaupan kassa
- Asiakas lisää tuotteita ostoskoriin
- Kauppias luo maksupyynnön tilauksen tiedoilla
- Asiakas skannaa QR-koodin tai napsauttaa maksupainiketta
- Lompakko näyttää eritellyn kuitin ja loppusumman
- Asiakas vahvistaa maksun
- Kauppias validoi transaktion ja toimittaa tilauksen
Myyntipiste
- Kassanhoitaja syöttää myyntisumman
- Kassajärjestelmä näyttää QR-koodin
- Asiakas skannaa mobiililompakon avulla
- Maksu käsitellään välittömästi
- Kuitti tulostetaan automaattisesti
Tilauspalvelut
- Käyttäjä tilaa palvelun
- Palvelu luo toistuvan maksuaikataulun
- Automaattinen järjestelmä generoi maksupyynnöt
- Käyttäjä hyväksyy maksut lompakon kautta
- Palvelu seuraa maksun tilaa
Parhaat käytännöt
URL:n luominen
- Käytä HTTPS:ää kaikissa transaktiopyynnön päätepisteissä
- Sisällytä kuvaavat tunnisteet ja viestit
- Luo yksilölliset viitteet maksujen seurantaa varten
- Vahvista kaikki parametrit ennen URL:n luomista
Tapahtumien käsittely
- Validoi tapahtumat aina palvelinpuolella
- Käytä turvallisuuden varmistamiseksi asianmukaista vahvistusten määrää
- Toteuta kunnollinen virheenkäsittely ja uudelleenyritykset
- Kirjaa maksutapahtumat täsmäytystä varten
Käyttökokemus
- Tarjoa selkeät maksuvahvistukset
- Näytä tapahtuman tilapäivitykset
- Käsittele lompakon yhdistäminen sujuvasti
- Tue useita lompakkovaihtoehtoja
Seuraavat vaiheet
Oletko valmis integroimaan Solana Payn? Aloita näistä oppaista:
- Asennusopas - SDK:n ja työkalujen asentaminen
- Siirtopyynnöt - Yksinkertaisten maksu-URL:ien luominen
- Tapahtumapyynnöt - Interaktiivisten työnkulkujen rakentaminen
- Integraatioesimerkit - Tosielämän toteutuksia
Resurssit
- Virallinen spesifikaatio - Täydellinen protokollaspesifikaatio
- GitHub-repositorio - Lähdekoodi ja esimerkit
- Brändiohjeistus - Logot ja brändimateriaalit
Is this page helpful?