Solana Pay là một giao thức chuẩn và tập hợp các triển khai tham chiếu cho phép các nhà phát triển tích hợp thanh toán phi tập trung vào ứng dụng và dịch vụ của họ. Nó cung cấp một cách tiếp cận thống nhất về thanh toán trên toàn hệ sinh thái Solana, đảm bảo khả năng tương thích giữa các ví, ứng dụng và dịch vụ.
Tổng quan Giao thức
Solana Pay định nghĩa hai loại yêu cầu thanh toán chính:
Yêu cầu Chuyển khoản (Không tương tác)
Yêu cầu chuyển khoản mô tả các giao dịch chuyển SOL hoặc token SPL đơn giản bằng cách sử dụng các tham số URL. Ví có thể trực tiếp soạn thảo và ký giao dịch mà không cần liên lạc với máy chủ.
solana:recipient?amount=1.5&spl-token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
Trường hợp Sử dụng:
- Thanh toán và quyên góp đơn giản
- Thanh toán bằng mã QR tại điểm bán hàng
- Liên kết thanh toán trong email hoặc tin nhắn
- Liên kết sâu trong ứng dụng di động
Yêu cầu Giao dịch (Tương tác)
Yêu cầu giao dịch cho phép các tương tác phức tạp bằng cách để ví giao tiếp với máy chủ để soạn thảo bất kỳ giao dịch Solana nào. Điều này mở ra các trường hợp sử dụng nâng cao vượt ra ngoài chuyển khoản đơn giản.
solana:https://merchant.com/api/payment
Trường hợp Sử dụng:
- Đúc NFT tại điểm bán hàng
- Định giá động và giảm giá
- Giao dịch DeFi nhiều bước
- Tích hợp chương trình khách hàng thân thiết
- Logic kinh doanh tùy chỉnh
Lợi ích Chính
Dành cho Nhà phát triển
- Giao thức Chuẩn: Một triển khai hoạt động trên tất cả các ví Solana
- Độc lập Khung công tác: Sử dụng với bất kỳ khung web hoặc nền tảng di động nào
- An toàn Kiểu dữ liệu: Hỗ trợ TypeScript đầy đủ trong JavaScript SDK
- Linh hoạt: Từ chuyển khoản đơn giản đến giao dịch nhiều lệnh phức tạp
Dành cho Người dùng
- Nhanh chóng: Giao dịch được xác nhận trong vòng chưa đầy một giây
- Rẻ: Chi phí trung bình $0.0005 mỗi giao dịch
- An toàn: Không có trung gian hoặc bên xử lý thứ ba
- Phổ biến: Hoạt động với bất kỳ ví Solana nào
Dành cho Người Bán
- Không Phí: Thanh toán trực tiếp không mất phí xử lý
- Thời gian thực: Thanh toán và xác nhận ngay lập tức
- Toàn cầu: Chấp nhận thanh toán từ bất kỳ đâu trên thế giới
- Có thể kết hợp: Tích hợp với các giao thức DeFi và thị trường NFT
Kiến Trúc Kỹ Thuật
Sơ Đồ URL
Solana Pay sử dụng sơ đồ URL tùy chỉnh solana: hoạt động trên các trình duyệt
web và hệ điều hành di động:
- Web: URL có thể được sử dụng như liên kết hoặc mã hóa trong mã QR
- Di động: Tích hợp liên kết sâu với các ứng dụng ví
- Máy tính: Trình xử lý giao thức để khởi chđộng ví một cách liền mạch
SDK JavaScript
SDK @solana/pay (được xây dựng trên @solana/kit) cung cấp:
- Client factories:
createMerchantClient,createWalletClient,createSolanaPayClientcho các luồng thanh toán có thể kết hợp - Mã hóa/phân tích URL:
encodeURL,parseURLcho các URL Solana Pay - Tạo giao dịch chuyển:
createTransfercho các lệnh thanh toán bằng SOL và token SPL - Xác thực thanh toán:
findReference,validateTransfer,watchReferenceđể phát hiện và xác minh thanh toán - Mã QR:
createQRtích hợp sẵn để tạo mã thanh toán có thể quét - Kit plugins:
solanaPayMerchant(),solanaPayWallet()để kết hợp với các plugin@solana/kitkhác
Tích Hợp Ví
Các ví hỗ trợ triển khai:
- Xử lý và phân tích sơ đồ URL
- Soạn thảo và xác thực giao dịch
- Luồng xác nhận từ người dùng
- Phát sóng và giám sát giao dịch
Ví Dụ Về Luồng Thanh Toán
Từ Ứng Dụng Web Đến Ví Di Động
- Ứng dụng web tạo mã QR với URL Solana Pay
- Người dùng quét mã QR bằng ứng dụng ví
- Ví phân tích URL và hiển thị chi tiết thanh toán
- Người dùng xác nhận thanh toán trong ví
- Ví ký và phát sóng giao dịch
- Ứng dụng web phát hiện xác nhận thanh toán
Từ Ứng Dụng Web Đến Ví Trình Duyệt
- Ứng dụng web hiển thị nút "Thanh toán bằng Solana"
- Người dùng nhấp vào nút để khởi động ví
- Tiện ích mở rộng ví hiển thị xác nhận thanh toán
- Người dùng phê duyệt giao dịch
- Giao dịch được ký và gửi đi
- Ứng dụng web nhận được xác nhận thanh toán
Ứng dụng di động đến ví di động
- Ứng dụng di động tạo liên kết sâu thanh toán
- Liên kết sâu khởi chạy ứng dụng ví
- Ví hiển thị xác nhận thanh toán
- Người dùng chấp thuận hoặc từ chối thanh toán
- Ví quay lại ứng dụng ban đầu
- Ứng dụng nhận kết quả thanh toán
Các vấn đề bảo mật
Dành cho người bán hàng
- Xác thực giao dịch: Luôn xác minh chi tiết giao dịch trên chuỗi
- Sử dụng tham chiếu: Bao gồm khóa tham chiếu duy nhất để xác định thanh toán
- Xác thực phía máy chủ: Tính toán số tiền và xác thực thanh toán phía máy chủ
- Giới hạn tốc độ: Triển khai giới hạn tốc độ phù hợp trên các điểm cuối thanh toán
Dành cho nhà phát triển ví
- Xác thực URL: Xác thực và làm sạch tất cả các thành phần URL
- Xác nhận người dùng: Luôn hiển thị chi tiết thanh toán rõ ràng cho người dùng
- Xác thực giao dịch: Xác minh nội dung giao dịch trước khi ký
- Chỉ HTTPS: Chỉ cho phép URL HTTPS cho các yêu cầu giao dịch
Các mô hình tích hợp
Thanh toán thương mại điện tử
- Khách hàng thêm sản phẩm vào giỏ hàng
- Người bán tạo yêu cầu thanh toán với chi tiết đơn hàng
- Khách hàng quét mã QR hoặc nhấp vào nút thanh toán
- Ví hiển thị hóa đơn chi tiết và tổng cộng
- Khách hàng xác nhận thanh toán
- Người bán xác thực giao dịch và thực hiện đơn hàng
Điểm bán hàng
- Thu ngân nhập số tiền bán hàng
- Hệ thống POS hiển thị mã QR
- Khách hàng quét bằng ví di động
- Thanh toán xử lý ngay lập tức
- Hóa đơn được in tự động
Dịch vụ đăng ký
- Người dùng đăng ký dịch vụ
- Dịch vụ tạo lịch thanh toán định kỳ
- Hệ thống tự động tạo yêu cầu thanh toán
- Người dùng phê duyệt thanh toán thông qua ví
- Dịch vụ theo dõi trạng thái thanh toán
Các phương pháp tốt nhất
Tạo URL
- Sử dụng HTTPS cho tất cả các điểm cuối yêu cầu giao dịch
- Bao gồm nhãn và thông báo mô tả
- Tạo tham chiếu duy nhất để theo dõi thanh toán
- Xác thực tất cả các tham số trước khi tạo URL
Xử lý Giao dịch
- Luôn xác thực giao dịch ở phía máy chủ
- Sử dụng số lần xác nhận phù hợp để đảm bảo bảo mật
- Triển khai xử lý lỗi và thử lại hợp lý
- Ghi lại các sự kiện thanh toán để đối chiếu
Trải nghiệm Người dùng
- Cung cấp xác nhận thanh toán rõ ràng
- Hiển thị cập nhật trạng thái giao dịch
- Xử lý kết nối ví một cách mượt mà
- Hỗ trợ nhiều tùy chọn ví
Các Bước Tiếp theo
Sẵn sàng tích hợp Solana Pay? Bắt đầu với các hướng dẫn sau:
- Hướng dẫn Cài đặt - Thiết lập SDK và công cụ
- Yêu cầu Chuyển khoản - Tạo URL thanh toán đơn giản
- Yêu cầu Giao dịch - Xây dựng luồng tương tác
- Ví dụ Tích hợp - Xem các triển khai thực tế
Tài nguyên
- Đặc tả Chính thức - Đặc tả giao thức đầy đủ
- Kho GitHub - Mã nguồn và ví dụ
- Hướng dẫn Thương hiệu - Logo và tài sản thương hiệu
Is this page helpful?