Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về
Apigee X. thông tin
Trước khi bắt đầu
Trước khi bắt đầu sử dụng tính năng kiếm tiền với tổ chức Apigee, bạn cần thực hiện các nhiệm vụ bắt buộc sau:
- Tạo tài khoản Apigee Edge, như mô tả trong phần Tạo tài khoản Apigee Edge.
- Kiếm tiền từ giao dịch mua. Ban đầu, Edge không bao gồm API kiếm tiền hoặc tích hợp tính năng kiếm tiền vào giao diện người dùng quản lý. Bạn cần mua tính năng kiếm tiền để tích hợp API kiếm tiền và các thành phần giao diện người dùng kiếm tiền vào Edge cho tổ chức Apigee của mình.
Sau khi mua gói kiếm tiền, bạn cần thực hiện các thao tác sau:
- Làm việc với nhóm cấu hình Apigee để hoàn tất việc thiết lập kiếm tiền ban đầu. Xem phần Thiết lập ban đầu với Apigee.
- Định cấu hình tính năng kiếm tiền. Xem bài viết Định cấu hình tính năng kiếm tiền.
- Kiếm tiền từ API. Xem bài viết Kiếm tiền từ API.
- Quản lý hoạt động kiếm tiền bằng cách tạo báo cáo, quản lý số dư tài khoản, v.v. Xem bài viết Quản lý hoạt động kiếm tiền.
Thiết lập ban đầu bằng Apigee
Làm việc với nhóm cấu hình Apigee Edge để hoàn tất việc thiết lập ban đầu cho tính năng kiếm tiền. Dựa trên thông tin bạn cung cấp, nhóm cấu hình sẽ thiết lập những nội dung sau:
- Tổ chức của bạn có phải là công ty viễn thông không.
- Loại hình thanh toán mà bạn muốn hỗ trợ cho những nhà phát triển mua gói giá: trả trước, trả sau hoặc cả hai. Xem bài viết Tài khoản trả trước so với tài khoản trả sau.
- Liệu bạn muốn dữ liệu được trích xuất từ hoạt động kiếm tiền được chuyển vào hệ thống kế toán của mình ở dạng chi tiết hay tóm tắt và định dạng dữ liệu bắt buộc.
- Địa chỉ trả lời email tuỳ chỉnh. Đối với thông báo qua email về việc kiếm tiền được gửi đến các công ty và nhà phát triển, hệ thống sẽ định cấu hình địa chỉ noreply@apigee.com mặc định. Bạn phải yêu cầu tên và địa chỉ trả lời tuỳ chỉnh cho tổ chức của mình.
Nhóm cấu hình Apigee chạy một tập lệnh để đồng bộ hoá hoạt động kiếm tiền với tổ chức của bạn và mọi nhà phát triển, ứng dụng và sản phẩm API mà bạn đã tạo bằng Apigee Edge. Nhóm hỗ trợ Apigee có thể yêu cầu bạn đồng bộ hoá tổ chức của mình trong tương lai, như mô tả trong phần Đồng bộ hoá dữ liệu Apigee Edge với tính năng kiếm tiền để biết thông tin chi tiết. Không đồng bộ hoá dữ liệu kiếm tiền trừ phi Apigee hướng dẫn.
Định cấu hình tính năng kiếm tiền
Bảng sau đây tóm tắt các bước cần thiết để định cấu hình tính năng kiếm tiền cho tổ chức Apigee của bạn.| Bước | Mô tả |
|---|---|
| Chỉnh sửa hồ sơ tổ chức | Trong quá trình thiết lập ban đầu để kiếm tiền, nhóm cấu hình Apigee Edge sẽ thiết lập hồ sơ tổ chức của bạn.
Bạn cần chỉnh sửa hồ sơ tổ chức để thêm hoặc cập nhật thông tin về tổ chức của mình (nếu cần). Ví dụ: bạn có thể cần cập nhật loại hình thanh toán, chế độ cài đặt đơn vị tiền tệ hoặc mô hình thuế. |
| Quản lý các đơn vị tiền tệ được hỗ trợ | Trong quá trình thiết lập tính năng kiếm tiền ban đầu, nhóm cấu hình Apigee Edge sẽ chỉ định các đơn vị tiền tệ mà tổ chức của bạn hỗ trợ và đặt đơn vị tiền tệ mặc định.
Bạn có thể truy xuất các đơn vị tiền tệ mà tổ chức của bạn hỗ trợ, đồng thời thêm hoặc xoá các đơn vị tiền tệ được hỗ trợ (để phản ánh đơn vị tiền tệ mà nhà phát triển hoặc gói giá sử dụng). Lưu ý: Tính năng kiếm tiền sẽ tự động chạy một công việc hằng ngày để lấy tỷ giá hối đoái bằng đô la Mỹ cho từng đơn vị tiền tệ được hỗ trợ. Theo mặc định, công việc này chạy mỗi ngày vào lúc 00:01. Để biết thông tin chi tiết, hãy xem bài viết Lên lịch công việc kiếm tiền. |
| Chỉ định điều khoản và điều kiện | Bạn có thể tuỳ ý thêm điều khoản và điều kiện vào hồ sơ tổ chức của mình trước khi xuất bản gói giá. Sau khi bạn xuất bản gói giá, phiên bản hiện tại của điều khoản và điều kiện sẽ xuất hiện trong cổng thông tin dành cho nhà phát triển. Lưu ý: Điều khoản và điều kiện nằm ngoài hồ sơ tổ chức của bạn. Trong hồ sơ tổ chức, bạn chỉ định vị trí (URL công khai) của các điều khoản và điều kiện. Bạn có thể thêm nhiều phiên bản điều khoản và điều kiện để phản ánh những thay đổi theo thời gian. |
| Thực thi các hạn mức kiếm tiền | Đính kèm chính sách MonetizationLimitsCheck vào proxy API để thực thi các giới hạn kiếm tiền. Cụ thể, chính sách này được kích hoạt trong các điều kiện sau:
|
| Thiết lập thông báo | Định cấu hình thông báo để thông báo cho nhà phát triển hoặc nhà cung cấp API về một sự kiện cụ thể, chẳng hạn như gói giá mới phát hành. |
Kiếm tiền từ API
Khi kiếm tiền từ API, bạn sẽ gói một hoặc nhiều sản phẩm API vào một gói sản phẩm API và xác định gói giá liên quan.
Gói sản phẩm API sẽ không hiển thị cho nhà phát triển cho đến khi bạn phát hành gói giá cho gói đó (với ngày bắt đầu là ngày hiện tại hoặc ngày trong tương lai). Nhà phát triển chỉ có thể đăng ký ứng dụng của họ để sử dụng gói sản phẩm API bằng cách mua một trong các gói giá hiện có hiệu lực. Nếu gói sản phẩm API không có gói giá đã xuất bản và đang có hiệu lực, thì gói đó sẽ không được kiếm tiền.
Bảng sau đây tóm tắt các bước cần thiết để kiếm tiền từ API.
| Bước | Mô tả |
|---|---|
| Quản lý gói sản phẩm API | Tạo gói sản phẩm API để nhóm các sản phẩm API của bạn. Lưu ý: Trong giao diện người dùng Edge cũ và API kiếm tiền, gói sản phẩm được gọi là gói API. Để sử dụng API nhằm quản lý gói sản phẩm API, hãy xem: |
| Định cấu hình chính sách ghi lại giao dịch | Định cấu hình chính sách ghi lại giao dịch cho từng sản phẩm API. Chính sách ghi lại giao dịch xác định những thông tin mà bạn muốn ghi lại trong bản ghi giao dịch cho một sản phẩm API, bao gồm mọi thuộc tính tuỳ chỉnh. Để sử dụng API nhằm định cấu hình chính sách ghi lại giao dịch, hãy xem: |
| Quản lý và xuất bản gói giá | Tạo gói giá để xác định phương pháp kiếm tiền cho các API của bạn. Ví dụ: bạn tính phí theo mức cố định hay mức biến động cho việc sử dụng API. Để quản lý gói giá bằng API, hãy xem: |
| Mua gói giá đã xuất bản | Mua một gói giá đã xuất bản và hết hạn hoặc huỷ một gói giá đã mua (nếu muốn) bằng API. |
| Định cấu hình tính năng kiếm tiền trong cổng thông tin dành cho nhà phát triển | Định cấu hình tính năng kiếm tiền trong cổng thông tin dành cho nhà phát triển để cung cấp cho nhà phát triển quyền tự phục vụ đối với gói thuê bao, quy trình xử lý và thanh toán tự động, báo cáo, danh mục sản phẩm và các chế độ cài đặt khác dành riêng cho tính năng kiếm tiền. |
Quản lý cài đặt kiếm tiền
Sau khi định cấu hình tính năng kiếm tiền và kiếm tiền từ API, bạn có thể thực hiện một hoặc nhiều bước được tóm tắt trong bảng sau:
| Bước | Mô tả |
|---|---|
| Quản lý công ty và nhà phát triển | Quản lý các công ty và nhà phát triển sử dụng API của bạn. Nhà phát triển là một pháp nhân duy nhất, được xác định bằng địa chỉ email. Công ty là một tập hợp các nhà phát triển được quản lý dưới dạng một pháp nhân duy nhất. |
| Tạo báo cáo | Tạo báo cáo về số dư trả trước, doanh thu và chênh lệch. Đối với nhà phát triển sử dụng phương thức trả trước, bạn có thể đối chiếu báo cáo số dư trả trước với khoản tiền gửi vào ngân hàng. |
| Điều chỉnh thông tin thanh toán | Ví dụ: điều chỉnh thông tin thanh toán để khắc phục sự chênh lệch trong hồ sơ của bạn. |
| Cấp tín dụng cho vấn đề | Cấp tín dụng cho nhà phát triển (nếu cần). Đối với nhà phát triển trả trước, khoản tín dụng sẽ xuất hiện dưới dạng mức sử dụng giảm, giúp tăng số dư trả trước của nhà phát triển trong tương lai. Đối với nhà phát triển trả sau, khoản tín dụng sẽ xuất hiện dưới dạng một dòng riêng trong hoá đơn, làm giảm khoản phí trong hoá đơn. |
| Quản lý số dư tài khoản trả trước | Xem số dư hiện tại của tài khoản trả trước và nạp tiền lại vào tài khoản trả trước hoặc thiết lập tính năng nạp tiền lại tự động bằng nhà cung cấp dịch vụ thanh toán bên thứ ba. |
| Quản lý số dư trả sau bằng hạn mức tín dụng | Khi thêm một đơn vị tiền tệ được hỗ trợ cho một tổ chức, bạn có thể đặt hạn mức tín dụng cho nhà phát triển trả sau. Hạn mức tín dụng áp dụng cho tất cả nhà phát triển trả sau trong tổ chức. Ngoài ra, bạn có thể đặt hạn mức tín dụng cho từng nhà phát triển trả sau. Trong trường hợp này, hạn mức tín dụng sẽ ghi đè mọi hạn mức được đặt cho đơn vị tiền tệ chỉ dành cho nhà phát triển được chỉ định. |
| Hoàn tiền sau | Đăng khoản hoàn tiền cho nhà phát triển đối với các giao dịch mua. |
| Lên lịch công việc kiếm tiền | Tính năng kiếm tiền cung cấp một trình lập lịch biểu công việc và một tập hợp các công việc được lên lịch trước để chạy vào thời điểm chỉ định. Quản lý lịch biểu công việc kiếm tiền bằng API. |
| Xem trạng thái của giao dịch | Xem trạng thái của các giao dịch đã xảy ra trong một phạm vi thời gian cụ thể bằng API. |
| Đồng bộ hoá dữ liệu Apigee Edge với tính năng kiếm tiền | Nếu Apigee hướng dẫn bạn làm như vậy, hãy đồng bộ hoá lại dữ liệu với tính năng kiếm tiền để đảm bảo dữ liệu được đồng bộ hoá. Bạn có thể đồng bộ hoá những mục sau: tổ chức, sản phẩm API, nhà phát triển và ứng dụng. |
| Xoá dữ liệu kiếm tiền khỏi tổ chức của bạn | Bạn có thể muốn xoá dữ liệu kiếm tiền khỏi tổ chức của mình để xoá một tổ chức thử nghiệm hoặc xoá một tổ chức. |