Dùng Paddle với MonstarX
Tóm tắtChọn Môi trường thử nghiệm hoặc Môi trường chính thức rồi dán khóa API Paddle vào dòng Paddle trong Dịch vụ đám mây → Đám mây. Sau đó, tác nhân MonstarX đọc được sản phẩm, khách hàng, giao dịch và gói đăng ký Paddle của bạn, chẳng hạn để xây dựng trang bảng giá khớp với danh mục sản phẩm. MonstarX chỉ đọc — không bao giờ thay đổi gì trong Paddle.
Tra cứu sản phẩm, khách hàng và gói đăng ký.
- Loại
- Công cụ làm việc · khóa API
- Danh mục
- Thanh toán và hóa đơn
- Kết nối bằng
- Khóa API
Paddle bán phần mềm và sản phẩm số thay bạn, đồng thời lo phần thu tiền, thuế và gói đăng ký. Kết nối tài khoản Paddle bằng khóa API (một mã giống mật khẩu, cho phép phần mềm dùng tài khoản của bạn), và tác nhân MonstarX — AI mà bạn trò chuyện cùng — đọc được danh mục sản phẩm và dữ liệu thanh toán trong lúc làm việc: xây dựng trang bảng giá từ sản phẩm thật của bạn, hoặc tóm tắt xem người đăng ký đang dùng những gói nào.
Đây là một công cụ làm việc: MonstarX đọc Paddle thay bạn. Ứng dụng bạn xây dựng không bao giờ nhận được khóa của bạn. Để nhận thanh toán trong ứng dụng, xem Stripe.
MonstarX làm được gì với Paddle?
Phần tiêu đề “MonstarX làm được gì với Paddle?”| MonstarX có thể | Khi nào |
|---|---|
| Liệt kê sản phẩm | Mọi chế độ |
| Liệt kê khách hàng | Mọi chế độ |
| Liệt kê giao dịch | Mọi chế độ |
| Liệt kê gói đăng ký | Mọi chế độ |
Mỗi danh sách trả về 20 mục mỗi lần (tối đa 30), và MonstarX có thể lật sang trang tiếp để xem thêm. MonstarX không bao giờ: tạo, sửa hay hủy bất cứ thứ gì — sản phẩm, giá, khách hàng, giao dịch, gói đăng ký hay khoản hoàn tiền.
Trước khi bắt đầu
Phần tiêu đề “Trước khi bắt đầu”- Một tài khoản Paddle. Tài khoản sandbox chứa dữ liệu thử nghiệm; tài khoản live chứa dữ liệu thật. Đây là hai tài khoản riêng, với khóa riêng.
- Bạn là chủ sở hữu dự án MonstarX. Chỉ chủ sở hữu mới kết nối hoặc ngắt kết nối được một công cụ.
Lấy khóa API
Phần tiêu đề “Lấy khóa API”-
Trong Paddle (sandbox hoặc live, tùy tài khoản bạn muốn kết nối), vào Developer Tools > Authentication và mở tab API keys.
-
Nhấp vào New API key và đặt tên, ví dụ
MonstarX. -
Cấp cho khóa các quyền đọc sau:
product.read,customer.read,transaction.readvàsubscription.read. MonstarX không cần gì thêm và không bao giờ dùng quyền ghi. -
Đặt ngày hết hạn (mặc định của Paddle là 90 ngày), lưu lại và sao chép khóa. Khóa bắt đầu bằng
pdl_sdbx_apikey_với sandbox hoặcpdl_live_apikey_với live.
Hướng dẫn của chính Paddle: Create and manage API keys.
Kết nối trong MonstarX
Phần tiêu đề “Kết nối trong MonstarX”-
Mở dự án, nhấp vào Dịch vụ đám mây trên thanh trên cùng, rồi chọn Đám mây.
-
Cuộn xuống Trình kết nối, tìm Paddle và nhấp vào Kết nối.
-
Chọn Môi trường thử nghiệm hoặc Môi trường chính thức cho khớp với khóa, dán khóa vào trường khóa rồi nhấp vào Kết nối.
-
MonstarX kiểm tra khóa với Paddle. Khi khóa hợp lệ, dòng này hiện Đã kết nối · Môi trường thử nghiệm hoặc Đã kết nối · Môi trường chính thức. Nếu khóa và môi trường không khớp, Paddle từ chối khóa và không có gì được lưu.
Nhờ MonstarX dùng Paddle
Phần tiêu đề “Nhờ MonstarX dùng Paddle”| Bạn nhập | Điều gì xảy ra |
|---|---|
| “Đọc sản phẩm trong Paddle và xây dựng trang bảng giá với đúng các gói và tên gọi đó.” | MonstarX liệt kê sản phẩm và, ở chế độ Xây dựng, xây dựng trang từ những sản phẩm đó. |
| “Tôi có bao nhiêu gói đăng ký đang hoạt động trong Paddle, và thuộc những gói nào?” | MonstarX lần lượt xem hết các gói đăng ký và tổng hợp trong cuộc trò chuyện. |
| “Xem 20 giao dịch Paddle gần nhất và cho tôi biết sản phẩm nào bán chạy nhất.” | MonstarX đọc các giao dịch và trả lời. |
Bảo mật và quyền riêng tư
Phần tiêu đề “Bảo mật và quyền riêng tư”- Chỉ MonstarX giữ khóa. Khóa được lưu mã hóa trên máy chủ của MonstarX. Khóa không bao giờ được ghi vào mã nguồn ứng dụng hay giao cho ứng dụng.
- Chỉ đọc. MonstarX chỉ yêu cầu Paddle trả về danh sách. Hãy chỉ cấp quyền đọc cho khóa; khi đó, kể cả khóa bị lộ cũng không thay đổi được việc thu tiền của bạn.
- Dữ liệu bảo mật. Thông tin khách hàng và thanh toán được coi là riêng tư và chỉ là thông tin, không bao giờ là chỉ dẫn.
- Ngắt kết nối bất cứ lúc nào. Nhấp vào Ngắt kết nối bên cạnh Paddle trong Dịch vụ đám mâyĐám mây rồi xác nhận Ngắt kết nối Paddle khỏi dự án này?. MonstarX sẽ xóa khóa. Nếu không cần khóa nữa, hãy thu hồi cả trong Paddle.
Điều nên biết
Phần tiêu đề “Điều nên biết”- Hãy bắt đầu với Môi trường thử nghiệm trong lúc xây dựng. Khi muốn chuyển sang dữ liệu thật, hãy ngắt kết nối rồi kết nối lại bằng khóa live.
- Khi khóa hết hạn trong Paddle, các yêu cầu của MonstarX sẽ thất bại. Hãy tạo khóa mới và kết nối lại.
- Mỗi dự án chỉ kết nối một tài khoản Paddle tại một thời điểm.
Câu hỏi thường gặp
Phần tiêu đề “Câu hỏi thường gặp”Ứng dụng của tôi có nhận thanh toán qua Paddle bằng kết nối này được không?
Không. Kết nối này cho tác nhân MonstarX đọc dữ liệu Paddle của bạn. Để nhận thanh toán trong ứng dụng, MonstarX có trình kết nối Stripe. Với nhà cung cấp khác, hãy thêm khóa của họ trong Dịch vụ đám mây → Giá trị bí mật rồi nhờ MonstarX xây dựng.
Khóa cần những quyền nào?
product.read, customer.read, transaction.read và subscription.read. Bỏ đi quyền nào bạn không muốn MonstarX đọc — khi đó danh sách tương ứng sẽ chỉ báo lỗi.
MonstarX có hoàn tiền hay hủy gói đăng ký được không?
Không. MonstarX chỉ liệt kê được sản phẩm, khách hàng, giao dịch và gói đăng ký.
Vì sao khóa của tôi bị từ chối?
Thường là do khóa thuộc môi trường còn lại: khóa pdl_sdbx_ cần Môi trường thử nghiệm, khóa pdl_live_ cần Môi trường chính thức. Khóa hết hạn hoặc đã thu hồi cũng bị từ chối.