Trang này được dịch bởi Cloud Translation API.

Hoàn tiền trên bài đăng

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến Tài liệu về Apigee X. thông tin

Giới thiệu

Tính năng kiếm tiền cho phép bạn đăng khoản tiền hoàn lại cho nhà phát triển đối với "giao dịch mua". Giả sử bạn là nhà cung cấp dịch vụ di động và bạn cung cấp cho nhà phát triển API thanh toán để tính phí thuê bao di động mua một ứng dụng hoặc nội dung trong ứng dụng. Mỗi khi người đăng ký sử dụng API để mua hàng, đó là giao dịch mua hàng.

Giao dịch mua hàng có thể dẫn đến việc hoàn tiền. Ví dụ: Nội dung có thể không được phân phối, hoặc bên thứ ba không hài lòng với giao dịch mua. Trong những trường hợp đó, nhà phát triển hoàn tiền cho bên thứ ba. Tính năng kiếm tiền cho phép bạn thực hiện một khoản hoàn tiền tương tự. Đây là đặc biệt phù hợp với kế hoạch chia sẻ doanh thu.

Hãy tưởng tượng rằng nhà phát triển hoàn tiền cho người đăng ký di động đã mua một khoản doanh thu cho sản phẩm API của bạn. Giả sử kế hoạch yêu cầu nhà phát triển nhận được 70% giá ròng/tổng giá của giao dịch mua. Bằng việc đăng khoản tiền hoàn lại, bạn sẽ đảo ngược giao dịch mua hàng, tức là bạn khấu trừ 70% số tiền phải trả cho nhà phát triển trong tháng đó thời điểm áp dụng khoản tiền hoàn lại (tháng có thể khác với tháng thực tế đã xảy ra giao dịch mua hàng).

Đăng hoàn tiền bằng cách sử dụng giao diện người dùng Classic Edge (chỉ Edge dành cho Private Cloud)

Bạn có thể đăng hoàn tiền cho bất kỳ trường hợp "thành công" nào giao dịch mua hàng, tức là khi API đã tính phí thành công cho bên thứ ba mà bạn chưa phát hành khoản tiền hoàn lại. Việc đăng tiền hoàn lại sẽ dẫn đến việc tạo giao dịch hoàn tiền với cha mẹ mã giao dịch, trong đó mã giao dịch là mã của giao dịch mua.

Bạn có thể đăng yêu cầu hoàn lại toàn bộ số tiền của giao dịch mua ban đầu hoặc cho một số tiền từng phần. Bạn cũng có thể đăng nhiều khoản tiền hoàn lại một phần, nhưng tổng số tiền của các khoản tiền hoàn lại không được nhiều hơn số tiền mua ban đầu.

Để đăng khoản tiền hoàn lại:

Trên thẻ Kiếm tiền, hãy chọn Hoàn tiền.

Thao tác này sẽ mở trang Hoàn tiền.
Trong trình đơn thả xuống Tháng thanh toán, hãy chọn tháng thực hiện giao dịch mua đã diễn ra. Sau đó, nhấp vào + Khoản tiền hoàn lại.
Thao tác này sẽ hiển thị danh sách tất cả các giao dịch mua hàng thành công cho 1 tháng.

Bạn có thể lọc danh sách hoàn tiền theo tên nhà phát triển hoặc bằng cách tìm kiếm trên giao dịch.

Để lọc theo nhà phát triển, hãy chọn nhà phát triển trong trình đơn thả xuống Nhà phát triển. Chiến dịch này chỉ hiển thị danh sách các giao dịch liên quan đến nhà phát triển đã chọn.

Để lọc theo mã giao dịch, hãy nhập mã giao dịch của giao dịch mua ban đầu mà bạn muốn hoàn tiền. Thao tác này sẽ trả về giao dịch của mã nhận dạng đó.
Đánh dấu vào hộp Chọn trong(các) hàng tương ứng với(các) giao dịch mà bạn muốn hoàn tiền.
Chọn Tổng số hoặc Một phần trong trình đơn thả xuống Loại.
Nếu bạn chọn Tổng cộng, tổng số tiền của giao dịch mua sẽ được hoàn lại. Nếu bạn chọn Một phần, số tiền mua hàng sẽ được hoàn lại một phần.

Nếu bạn chọn Một phần, hãy nhập số tiền của khoản hoàn trả một phần vào trường Số tiền. Bạn có thể chỉ hoàn tiền tối đa là tổng số tiền đã mua. Nếu bạn đã đăng một phần hoàn tiền, bạn chỉ có thể nhập một số tiền tối đa là số tiền còn lại của giao dịch mua. Ngoài ra, nếu giao dịch mua ban đầu có cả giá gộp và giá ròng, bạn cũng cần phải nêu rõ cho dù một phần số tiền mà bạn muốn hoàn lại là tổng giá trị hay ròng.
Nhấp vào Lưu để xử lý khoản tiền hoàn lại (hoặc Huỷ để huỷ).
Khoản tiền hoàn lại sẽ được ghi vào tháng mua hàng ban đầu nếu tháng thanh toán vẫn là nếu không thì khoản tiền hoàn lại sẽ được ghi vào ngày hiện tại.

Đối với giao dịch hoàn tiền một phần, khoản tiền hoàn lại sẽ được xử lý cho một phần số tiền và mọi phần doanh thu chia sẻ sẽ được khấu trừ dựa trên tỷ lệ của một phần số tiền trên tổng số tiền. Trong ví dụ về hoàn tiền một phần ở trên, số tiền một phần là 0,50/1,12 = 45% tổng giá, vì vậy 45% phần doanh thu chia sẻ của nhà phát triển sẽ bị khấu trừ.

Kiểm tra trong giao diện người dùng để xem việc hoàn tiền đã được thực hiện hay chưa đã xử lý

Bạn có thể xác định xem khoản tiền hoàn lại đã được xử lý hay chưa bằng cách chọn tháng thanh toán ở đầu trang Hoàn lại tiền. Đây là tháng mà người dùng mua hàng nếu tháng thanh toán vẫn còn hiệu lực hoặc tháng hiện tại nếu tháng thanh toán đã đóng. Thao tác này sẽ hiển thị danh sách tất cả các khoản tiền hoàn lại đã được đăng trong tháng.

Đăng khoản tiền hoàn lại bằng API

Để đăng khoản tiền hoàn lại, hãy đưa ra yêu cầu POST tới /organizations/{org_name}/monetization-packages/{package_id}/refund-transactions, trong đó {package_id} là thông tin nhận dạng gói API mà khoản tiền hoàn lại sẽ được áp dụng.

Khi gửi yêu cầu, bạn cần chỉ định làm tham số truy vấn:

Mã nhận dạng giao dịch mua đang được hoàn tiền.
Loại doanh thu (GROSS hoặc NET) của giao dịch mua hàng.
Số tiền hoàn lại.
Ghi chú mô tả lý do hoàn tiền.

Nếu muốn, bạn có thể xác định gói đó là một tham số URL sẽ được áp dụng.

Xem phần Cài đặt cấu hình hoàn tiền để biết danh sách đầy đủ của URL mà bạn có thể chỉ định trong yêu cầu hoàn tiền.

Ví dụ: Yêu cầu sau đây hoàn tiền cho một giao dịch mua. Khoản tiền hoàn lại 50% tổng số tiền của giao dịch mua hàng.

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/refund-transactions?revenueType=GROSS&refundAmount=0.5&parentTxId=abf50909-2492-4bf5-8704-ade05f4d43b3&transactionNote=Refund for purchase transaction" \
-u email:password

Câu trả lời sẽ có dạng như sau (chỉ một phần của câu trả lời được hiển thị):

{
  "application" : {
    ...
    },
    "product" : [ {
      ...
      
     {
      "customAtt1Name" : "user",
      "description" : "Payment",
      "displayName" : "Payment",
      "id" : "payment",
      "name" : "payment",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    } ],
    ...
  },
  "currency" : "USD",
  "developer" : {
    ...
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
      ...
    },
    ...
  },
  "endTime" : "2013-09-01 21:59:59",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8123,
  "gbpExchangeRate" : 0.6910,
  "grossPrice" : 0.5,
  "id" : "61f7eb88-f8cc-4cda-afd8-4a61fba3dd33",
  "isRevOnGrossOrNet" : "NET",
  "isVirtualCurrency" : false,
  "notes" : "Refund for purchase transaction",
  "itemDesc" : "test application",
  "netPrice" : 0.4464,
  "orgRevenueShareAmount" : 0.1339,
  "parentId" : "abf50909-2492-4bf5-8704-ade05f4d43b3",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  ...
  },
  "ratePlanLevel" : "STANDARD",
  "revenueShareAmount" : 0.3125,
  "startTime" : "2013-09-01 21:59:59",
  "status" : "SUCCESS",
  "tax" : 0.0536,
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "REFUND",
  "usdExchangeRate" : 1.0724,
  "utcEndTime" : "2013-09-01 21:59:59",
  "utcStartTime" : "2013-09-01 21:59:59"
}

Chế độ cài đặt cấu hình hoàn tiền cho API

Bạn có thể chỉ định các tham số truy vấn sau trong yêu cầu hoàn tiền:

Tên	Mô tả	Mặc định	Bắt buộc?
`monetizationPackageId`	Gói API áp dụng yêu cầu hoàn tiền.	Không áp dụng	Không
`parentTxId`	Giao dịch mua được hoàn tiền.	Không áp dụng	Có
`revenueType`	Loại doanh thu (`GROSS` hoặc `NET`) của giao dịch mua giao dịch.	Không áp dụng	Có
`refundAmount`	Số tiền hoàn lại.	Không áp dụng	Có
`transactionNote`	Ghi chú văn bản mô tả lý do hoàn tiền.	Không áp dụng	Có

Các bước tiếp theo

Tìm hiểu cách lên lịch các công việc có liên quan đến kiếm tiền và về các công việc đã lên lịch tự động trong Lịch biểu việc làm trong lĩnh vực kiếm tiền.