Επισκόπηση

Το Solana Pay είναι ένα τυποποιημένο πρωτόκολλο και ένα σύνολο υλοποιήσεων αναφοράς που επιτρέπουν στους προγραμματιστές να ενσωματώσουν αποκεντρωμένες πληρωμές στις εφαρμογές και τις υπηρεσίες τους. Παρέχει μια ενοποιημένη προσέγγιση για τις πληρωμές σε όλο το οικοσύστημα της Solana, διασφαλίζοντας τη συμβατότητα μεταξύ πορτοφολιών, εφαρμογών και υπηρεσιών.

Επισκόπηση Πρωτοκόλλου

Το Solana Pay ορίζει δύο κύριους τύπους αιτημάτων πληρωμής:

Αιτήματα Μεταφοράς (Μη Διαδραστικά)

Τα αιτήματα μεταφοράς περιγράφουν απλές μεταφορές SOL ή SPL tokens χρησιμοποιώντας παραμέτρους URL. Το πορτοφόλι μπορεί να συνθέσει και να υπογράψει απευθείας τη συναλλαγή χωρίς πρόσθετη επικοινωνία με τον διακομιστή.

solana:recipient?amount=1.5&spl-token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Περιπτώσεις Χρήσης:

• Απλές πληρωμές και δωρεές
• Πληρωμές με κωδικό QR στο σημείο πώλησης
• Σύνδεσμοι πληρωμής σε emails ή μηνύματα
• Βαθιά σύνδεση σε εφαρμογές για κινητά

Αιτήματα Συναλλαγών (Διαδραστικά)

Τα αιτήματα συναλλαγών επιτρέπουν σύνθετες αλληλεπιδράσεις μέσω επικοινωνίας του πορτοφολιού με έναν διακομιστή για τη σύνθεση οποιασδήποτε συναλλαγής Solana. Αυτό ξεκλειδώνει προηγμένες περιπτώσεις χρήσης πέρα από τις απλές μεταφορές.

solana:https://merchant.com/api/payment

Περιπτώσεις Χρήσης:

• Δημιουργία NFT στο σημείο πώλησης
• Δυναμική τιμολόγηση και εκπτώσεις
• Πολυβηματικές συναλλαγές DeFi
• Ενσωμάτωση προγραμμάτων επιβράβευσης
• Προσαρμοσμένη επιχειρηματική λογική

Βασικά Πλεονεκτήματα

Για τους Προγραμματιστές

• Τυποποιημένο Πρωτόκολλο: Μία υλοποίηση λειτουργεί σε όλα τα πορτοφόλια Solana
• Ανεξάρτητο από Framework: Χρησιμοποιήστε το με οποιοδήποτε web framework ή πλατφόρμα για κινητά
• Ασφάλεια Τύπων: Πλήρης υποστήριξη TypeScript στο JavaScript SDK
• Ευέλικτο: Από απλές μεταφορές έως σύνθετες συναλλαγές πολλαπλών εντολών

Για τους Χρήστες

• Γρήγορο: Οι συναλλαγές επιβεβαιώνονται σε λιγότερο από ένα δευτερόλεπτο
• Οικονομικό: Μέσο κόστος $0,0005 ανά συναλλαγή
• Ασφαλές: Χωρίς μεσάζοντες ή επεξεργαστές τρίτων μερών
• Καθολικό: Λειτουργεί με οποιοδήποτε πορτοφόλι Solana

Για Εμπόρους

• Χωρίς Χρεώσεις: Άμεσες πληρωμές χωρίς προμήθειες επεξεργασίας
• Σε Πραγματικό Χρόνο: Άμεση διακανονισμός και επιβεβαίωση
• Παγκόσμιες: Δέχεστε πληρωμές από οποιοδήποτε σημείο του κόσμου
• Συνθέσιμες: Ενσωμάτωση με πρωτόκολλα DeFi και αγορές NFT

Τεχνική Αρχιτεκτονική

Σχήμα URL

Το Solana Pay χρησιμοποιεί ένα προσαρμοσμένο σχήμα URL solana: που λειτουργεί σε περιηγητές ιστού και λειτουργικά συστήματα κινητών:

• Ιστός: Τα URL μπορούν να χρησιμοποιηθούν ως σύνδεσμοι ή να κωδικοποιηθούν σε κωδικούς QR
• Κινητά: Ενσωμάτωση βαθιάς σύνδεσης με εφαρμογές πορτοφολιών
• Επιτραπέζιοι Υπολογιστές: Χειριστές πρωτοκόλλου για απρόσκοπτη εκκίνηση πορτοφολιού

JavaScript SDK

Το SDK @solana/pay (βασισμένο στο @solana/kit) παρέχει:

• Εργοστάσια πελατών: createMerchantClient, createWalletClient, createSolanaPayClient για συνθέσιμες ροές πληρωμών
• Κωδικοποίηση/ανάλυση URL: encodeURL, parseURL για URL Solana Pay
• Δημιουργία μεταφοράς: createTransfer για οδηγίες πληρωμής SOL και SPL token
• Επικύρωση πληρωμής: findReference, validateTransfer, watchReference για ανίχνευση και επαλήθευση πληρωμών
• Κωδικοί QR: Ενσωματωμένο createQR για δημιουργία σαρώσιμων κωδικών πληρωμής
• Πρόσθετα Kit: solanaPayMerchant(), solanaPayWallet() για σύνθεση με άλλα πρόσθετα @solana/kit

Ενσωμάτωση Πορτοφολιού

Τα υποστηριζόμενα πορτοφόλια υλοποιούν:

• Χειρισμό και ανάλυση σχήματος URL
• Σύνθεση και επικύρωση συναλλαγών
• Ροές επιβεβαίωσης χρήστη
• Μετάδοση και παρακολούθηση συναλλαγών

Παραδείγματα Ροής Πληρωμών

Εφαρμογή Ιστού σε Πορτοφόλι Κινητού

1. Η εφαρμογή ιστού δημιουργεί κωδικό QR με URL Solana Pay
2. Ο χρήστης σαρώνει τον κωδικό QR με την εφαρμογή πορτοφολιού
3. Το πορτοφόλι αναλύει το URL και εμφανίζει τα στοιχεία πληρωμής
4. Ο χρήστης επιβεβαιώνει την πληρωμή στο πορτοφόλι
5. Το πορτοφόλι υπογράφει και μεταδίδει τη συναλλαγή
6. Η εφαρμογή ιστού ανιχνεύει την επιβεβαίωση πληρωμής

Εφαρμογή Ιστού σε Πορτοφόλι Περιηγητή

1. Η εφαρμογή ιστού εμφανίζει κουμπί "Πληρώστε με Solana"
2. Ο χρήστης κάνει κλικ στο κουμπί για να εκκινήσει το πορτοφόλι
3. Η επέκταση πορτοφολιού εμφανίζει επιβεβαίωση πληρωμής
4. Ο χρήστης εγκρίνει τη συναλλαγή
5. Η συναλλαγή υπογράφεται και αποστέλλεται
6. Η εφαρμογή ιστού λαμβάνει επιβεβαίωση πληρωμής

Εφαρμογή Mobile σε Πορτοφόλι Mobile

1. Η εφαρμογή mobile δημιουργεί deep link πληρωμής
2. Το deep link εκκινεί την εφαρμογή πορτοφολιού
3. Το πορτοφόλι εμφανίζει επιβεβαίωση πληρωμής
4. Ο χρήστης εγκρίνει ή απορρίπτει την πληρωμή
5. Το πορτοφόλι επιστρέφει στην αρχική εφαρμογή
6. Η εφαρμογή λαμβάνει το αποτέλεσμα πληρωμής

Θέματα Ασφάλειας

Για Εμπόρους

• Επικύρωση Συναλλαγών: Επαληθεύετε πάντα τα στοιχεία συναλλαγών on-chain
• Χρήση Αναφορών: Συμπεριλάβετε μοναδικά κλειδιά αναφοράς για την αναγνώριση πληρωμών
• Επικύρωση από την Πλευρά του Διακομιστή: Υπολογίζετε ποσά και επικυρώνετε πληρωμές από την πλευρά του διακομιστή
• Περιορισμός Ρυθμού: Εφαρμόστε κατάλληλους περιορισμούς ρυθμού στα endpoints πληρωμών

Για Προγραμματιστές Πορτοφολιών

• Επικύρωση URL: Επικυρώνετε και καθαρίζετε όλα τα στοιχεία URL
• Επιβεβαίωση Χρήστη: Εμφανίζετε πάντα σαφή στοιχεία πληρωμής στους χρήστες
• Επικύρωση Συναλλαγής: Επαληθεύετε τα περιεχόμενα της συναλλαγής πριν την υπογραφή
• Μόνο HTTPS: Επιτρέπετε μόνο HTTPS URLs για αιτήματα συναλλαγών

Μοτίβα Ενσωμάτωσης

Ολοκλήρωση Αγοράς E-commerce

1. Ο πελάτης προσθέτει προϊόντα στο καλάθι
2. Ο έμπορος δημιουργεί αίτημα πληρωμής με τα στοιχεία παραγγελίας
3. Ο πελάτης σαρώνει τον κωδικό QR ή κάνει κλικ στο κουμπί πληρωμής
4. Το πορτοφόλι εμφανίζει αναλυτική απόδειξη και σύνολο
5. Ο πελάτης επιβεβαιώνει την πληρωμή
6. Ο έμπορος επικυρώνει τη συναλλαγή και εκτελεί την παραγγελία

Σημείο Πώλησης

1. Ο ταμίας εισάγει το ποσό πώλησης
2. Το σύστημα ταμειακής μηχανής εμφανίζει κωδικό QR
3. Ο πελάτης σαρώνει με το πορτοφόλι mobile
4. Η πληρωμή επεξεργάζεται άμεσα
5. Η απόδειξη εκτυπώνεται αυτόματα

Υπηρεσίες Συνδρομής

1. Ο χρήστης εγγράφεται στην υπηρεσία
2. Η υπηρεσία δημιουργεί πρόγραμμα επαναλαμβανόμενων πληρωμών
3. Το αυτοματοποιημένο σύστημα δημιουργεί αιτήματα πληρωμής
4. Ο χρήστης εγκρίνει τις πληρωμές μέσω του πορτοφολιού
5. Η υπηρεσία παρακολουθεί την κατάσταση πληρωμής

Βέλτιστες Πρακτικές

Δημιουργία URL

• Χρησιμοποιείτε HTTPS για όλα τα endpoints αιτημάτων συναλλαγών
• Συμπεριλάβετε περιγραφικές ετικέτες και μηνύματα
• Δημιουργείτε μοναδικές αναφορές για την παρακολούθηση πληρωμών
• Επικυρώνετε όλες τις παραμέτρους πριν τη δημιουργία URL

Διαχείριση Συναλλαγών

• Να επικυρώνετε πάντα τις συναλλαγές από την πλευρά του διακομιστή
• Να χρησιμοποιείτε κατάλληλο αριθμό επιβεβαιώσεων για ασφάλεια
• Να εφαρμόζετε σωστό χειρισμό σφαλμάτων και επανάληψεις
• Να καταγράφετε γεγονότα πληρωμών για συμφωνία

Εμπειρία Χρήστη

• Να παρέχετε σαφείς επιβεβαιώσεις πληρωμής
• Να εμφανίζετε ενημερώσεις κατάστασης συναλλαγών
• Να διαχειρίζεστε τη σύνδεση πορτοφολιού με ομαλό τρόπο
• Να υποστηρίζετε πολλαπλές επιλογές πορτοφολιού

Επόμενα Βήματα

Είστε έτοιμοι να ενσωματώσετε το Solana Pay; Ξεκινήστε με αυτούς τους οδηγούς:

• Οδηγός Εγκατάστασης - Ρυθμίστε το SDK και τα εργαλεία
• Αιτήματα Μεταφοράς - Δημιουργήστε απλά URL πληρωμής
• Αιτήματα Συναλλαγών - Κατασκευάστε διαδραστικές ροές
• Παραδείγματα Ενσωμάτωσης - Δείτε υλοποιήσεις πραγματικών συνθηκών

Πόροι

• Επίσημη Προδιαγραφή - Πλήρης προδιαγραφή πρωτοκόλλου
• Αποθετήριο GitHub - Πηγαίος κώδικας και παραδείγματα
• Οδηγίες Εταιρικής Ταυτότητας - Λογότυπα και στοιχεία εταιρικής ταυτότητας