Tổng quan

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, createSolanaPayClient cho các luồng thanh toán có thể kết hợp
  • Mã hóa/phân tích URL: encodeURL, parseURL cho các URL Solana Pay
  • Tạo giao dịch chuyển: createTransfer cho 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: createQR tí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/kit khá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

  1. Ứng dụng web tạo mã QR với URL Solana Pay
  2. Người dùng quét mã QR bằng ứng dụng ví
  3. Ví phân tích URL và hiển thị chi tiết thanh toán
  4. Người dùng xác nhận thanh toán trong ví
  5. Ví ký và phát sóng giao dịch
  6. Ứ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

  1. Ứng dụng web hiển thị nút "Thanh toán bằng Solana"
  2. Người dùng nhấp vào nút để khởi động ví
  3. Tiện ích mở rộng ví hiển thị xác nhận thanh toán
  4. Người dùng phê duyệt giao dịch
  5. Giao dịch được ký và gửi đi
  6. Ứng dụng web nhận được xác nhận thanh toán

Ứng dụng di động đến ví di động

  1. Ứng dụng di động tạo liên kết sâu thanh toán
  2. Liên kết sâu khởi chạy ứng dụng ví
  3. Ví hiển thị xác nhận thanh toán
  4. Người dùng chấp thuận hoặc từ chối thanh toán
  5. Ví quay lại ứng dụng ban đầu
  6. Ứ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ử

  1. Khách hàng thêm sản phẩm vào giỏ hàng
  2. Người bán tạo yêu cầu thanh toán với chi tiết đơn hàng
  3. Khách hàng quét mã QR hoặc nhấp vào nút thanh toán
  4. Ví hiển thị hóa đơn chi tiết và tổng cộng
  5. Khách hàng xác nhận thanh toán
  6. 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

  1. Thu ngân nhập số tiền bán hàng
  2. Hệ thống POS hiển thị mã QR
  3. Khách hàng quét bằng ví di động
  4. Thanh toán xử lý ngay lập tức
  5. Hóa đơn được in tự động

Dịch vụ đăng ký

  1. Người dùng đăng ký dịch vụ
  2. Dịch vụ tạo lịch thanh toán định kỳ
  3. Hệ thống tự động tạo yêu cầu thanh toán
  4. Người dùng phê duyệt thanh toán thông qua ví
  5. 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:

Tài nguyên

Is this page helpful?

Quản lý bởi

© 2026 Solana Foundation.
Đã đăng ký bản quyền.
Kết nối