Thực hiện điều chỉnh thanh toán

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 giúp bạn điều chỉnh thông tin thanh toán. Ví dụ: bạn có thể cần để tăng hoặc giảm chia sẻ doanh thu hoặc phí cho một tháng thanh toán cụ thể do trong hồ sơ của mình.

Khám phá trang Điều chỉnh thanh toán

Truy cập vào trang Điều chỉnh thanh toán, như được mô tả bên dưới.

Thêm điều chỉnh thanh toán

Cách thêm mức điều chỉnh thanh toán:

1. Truy cập trang Điều chỉnh thanh toán.
2. Nhấp vào + Điều chỉnh.
3. Nhập thông tin dưới đây:

   Trường	Mô tả
   Tên	Tên mô tả sẽ xuất hiện trên chứng từ thanh toán.
   % điều chỉnh	Số tiền điều chỉnh, dưới dạng tỷ lệ phần trăm dương hoặc âm. A tích cực sẽ điều chỉnh tỷ lệ chia sẻ doanh thu hoặc phí trong giao dịch bằng cách phần trăm. Điều chỉnh âm sẽ điều chỉnh giảm chia sẻ doanh thu hoặc phí trong theo tỷ lệ phần trăm đó. Nhập số thập phân dương hoặc âm (có giá trị lên đến 2 chữ số thập phân).
   Tháng thanh toán	Tháng thanh toán cho việc điều chỉnh. Chọn một tháng trong danh sách thả xuống.
   Loại giao dịch	Loại giao dịch mà bạn muốn áp dụng mức điều chỉnh. Chọn một giá trị trong trình đơn thả xuống: Tất cả các phiên Giao dịch Tính phí (các giao dịch theo mô hình tính phí) Mua (các giao dịch theo mô hình chia sẻ doanh thu) Tiền hoàn lại (các giao dịch sử dụng mô hình chia sẻ doanh thu)
   Sản phẩm	Sản phẩm API mà bạn muốn áp dụng mức điều chỉnh. Bạn không thể áp dụng một điều chỉnh cho nhiều sản phẩm API. Nếu bạn cần áp dụng điều chỉnh cho nhiều sản phẩm API, hãy tạo nội dung điều chỉnh cho từng sản phẩm. Chọn một sản phẩm API từ trình đơn thả xuống.
   Nhà phát triển	Nhà phát triển mà bạn muốn áp dụng mức điều chỉnh. Bạn có thể áp dụng điều chỉnh cho tất cả các nhà phát triển (theo mặc định) hoặc cho một nhà phát triển cụ thể. Chọn "Tất cả Nhà phát triển" hoặc một nhà phát triển cụ thể từ trình đơn thả xuống.

4. Nhấp vào Tạo mức điều chỉnh.

Chỉnh sửa điều chỉnh thanh toán

Để chỉnh sửa điều chỉnh thanh toán:

1. Truy cập trang Điều chỉnh thanh toán.
2. Di chuyển con trỏ lên mức điều chỉnh thanh toán mà bạn muốn chỉnh sửa rồi nhấp vào trong trình đơn hành động.
3. Cập nhật điều chỉnh thanh toán, nếu bắt buộc.
4. Nhấp vào Cập nhật điều chỉnh.

Điều chỉnh thanh toán bằng API

Các phần sau đây mô tả cách điều chỉnh việc thanh toán bằng API.

Điều chỉnh việc thanh toán bằng API

Bạn có thể điều chỉnh chi tiết thanh toán bằng cách gửi yêu cầu POST cho /organizations/{org_name}/billing-adjustments. Khi đưa ra yêu cầu, bạn chỉ định trong nội dung yêu cầu:

• Tên của mức điều chỉnh thanh toán.
• Tỷ lệ phần trăm điều chỉnh, tức là giá trị phần trăm dương hoặc âm sẽ tăng hoặc giảm hoá đơn tương ứng.
• Tháng thanh toán.
• Năm thanh toán.
• Tổ chức áp dụng mức điều chỉnh thanh toán.

Bạn cũng có thể chỉ định các thuộc tính khác, chẳng hạn như:

• Loại giao dịch mà bạn muốn áp dụng mức điều chỉnh (chẳng hạn như một giao dịch mua giao dịch).
• Nhà phát triển mà bạn muốn áp dụng mức điều chỉnh.
• Bạn muốn áp dụng mức điều chỉnh này cho nhà phát triển trả trước, nhà phát triển trả sau hay cả hai.
• Gói API mà bạn muốn áp dụng mức điều chỉnh.
• Sản phẩm API mà bạn muốn áp dụng mức điều chỉnh.

Xem Cài đặt cấu hình điều chỉnh thanh toán để biết danh sách đầy đủ thuộc tính điều chỉnh thanh toán mà bạn có thể chỉ định trong yêu cầu điều chỉnh.

Nếu bạn không chỉ định một thuộc tính không bắt buộc, thì nội dung điều chỉnh trên chứng từ thanh toán sẽ là toàn bộ cho cơ sở lưu trú đó. Ví dụ: nếu không có loại giao dịch nào được chỉ định, việc thanh toán mức điều chỉnh sẽ áp dụng cho tất cả các loại giao dịch.

Ví dụ sau đây thực hiện điều chỉnh thanh toán cho tháng thanh toán chưa thanh toán, tháng 6 năm 2013. Chiến lược phát hành đĩa đơn điều chỉnh sẽ giảm xuống hệ số 3% và được áp dụng cho các giao dịch mua, sản phẩm thanh toán và nhà phát triển trả sau. Vì các thuộc tính để xác định một nhà phát triển hoặc gói API chưa được chỉ định, thì nội dung điều chỉnh sẽ được áp dụng cho tất cả các nhà phát triển ( là nhà phát triển trả sau) và sản phẩm thanh toán trong tất cả các gói API.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "name": "Purchase Adjustment Negative3",
  "adjustmentPercentageFactor": -3,
  "billingMonth": 6,
  "billingYear": 2017,
  "isPublished": false,
  "transactionType": "PURCHASE",
  "developerBillingType": "POSTPAID",
  "organization": {
      "id": "{org_name}" 
  },
  "product": { "id": "payment" }
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments" \
-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ị):

{
  "adjustmentPercentageFactor" : -3,
  "billingMonth" : 6,
  "billingYear" : 2017,
  "developerBillingType" : "POSTPAID",
  "id" : "511144db-7fb1-4c74-bafb-5bc7a6380c9c",
  "isPublished" : false,
  "name" : "Purchase Adjustment Negative3",
  "organization" : {
   ...
  },
  "product" : {
    "customAtt1Name" : "user",
    "description" : "Payment",
    "displayName" : "Payment",
    "id" : "payment",
    "name" : "payment",
    "organization" : {
      ...
    },
    "status" : "CREATED",
    "transactionSuccessCriteria" : "Status=='200 OK'"
  },
  "transactionType" : "PURCHASE"
}

Xem điều chỉnh thanh toán bằng API

Bạn có thể xem một mức điều chỉnh thanh toán cụ thể hoặc tất cả các mức điều chỉnh thanh toán của một tổ chức. Để xem điều chỉnh thanh toán cụ thể, hãy gửi yêu cầu GET tới /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}, trong đó {billing_adjustment_id} là cách xác định khoản điều chỉnh thanh toán cụ thể (mã nhận dạng được trả về trong nội dung phản hồi khi bạn tạo mức điều chỉnh thanh toán). Ví dụ:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments/511144db-7fb1-4c74-bafb-5bc7a6380c9c" \
-u email:password

Để xem tất cả các điều chỉnh thanh toán cho một tổ chức, hãy gửi yêu cầu GET tới /organizations/{org_name}/billing-adjustments. Ví dụ:

$ curl -H "Accept:application/json" -X GET \ 
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments" \ 
-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ị):

{
  "billingAdjustment" : [ {
    "adjustmentPercentageFactor" : -3,
    "billingMonth" : 6,
    "billingYear" : 2017,
    "developerBillingType" : "POSTPAID",
    "id" : "511144db-7fb1-4c74-bafb-5bc7a6380c9c",
    "isPublished" : false,
    "name" : "Purchase Adjustment Negative3",
    "organization" : {
      ...
    },
    "product" : {
      "customAtt1Name" : "user",
      "description" : "Payment",
      "displayName" : "Payment",
      "id" : "payment",
      "name" : "payment",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    },
    "transactionType" : "PURCHASE"
  }, {
    "adjustmentPercentageFactor" : 5.0000,
    "billingMonth" : 5,
    "billingYear" : 2017,
    "id" : "53c363c0-7e1d-4dc1-9392-cf86656225f2",
    "isPublished" : false,
    "monetizationPackage" : {
      "description" : "Communications",
      "displayName" : "Communications",
      "id" : "communications",
      "name" : "Communications",
      "organization" : {
       ...
      },
      "product" : [ {
        "customAtt1Name" : "user",
        "description" : "Messaging",
        "displayName" : "Messaging",
        "id" : "messaging",
        "name" : "messaging",
        "organization" : {
          ...
        },
        "status" : "CREATED"
      }, {
        ...
        },
        "status" : "CREATED",
        "transactionSuccessCriteria" : "Status=='200 OK'"
      } ],
      "status" : "CREATED"
    },
    "name" : "Test Package Adjustment",
    "organization" : {
     ...
    },
    "product" : {
      "customAtt1Name" : "user",
      "description" : "Location",
      "displayName" : "Location",
      "id" : "location",
      "name" : "location",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    }
  } ],
  "totalRecords" : 2
}

Cập nhật điều chỉnh thanh toán bằng API

Bạn có thể cập nhật điều chỉnh thanh toán bằng cách gửi yêu cầu PUT cho /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}, trong đó {billing_adjustment_id} là cách xác định khoản điều chỉnh thanh toán cụ thể. Khi cập nhật, bạn cần chỉ định trong nội dung yêu cầu các thuộc tính được cập nhật và nhận dạng điều chỉnh thanh toán cần cập nhật. Bạn cũng cần chỉ định thuộc tính cho điều chỉnh thanh toán, tức là thuộc tính theo tên, tỷ lệ điều chỉnh, tháng thanh toán, năm thanh toán và tổ chức.

Ví dụ: lệnh gọi API sau đây cập nhật tên và hệ số tỷ lệ phần trăm điều chỉnh (giá trị các thuộc tính đã cập nhật được làm nổi bật trong ví dụ):

$ curl -H "Content-Type: application/json" -X PUT -d \
'{
  "id" : "511144db-7fb1-4c74-bafb-5bc7a6380c9c ",
  "adjustmentPercentageFactor": -5,
  "name" : "Purchase Adjustment Negative5",
  "billingMonth": 6,
  "billingYear": 2017,
  "isPublished": false,
  "transactionType": "PURCHASE",
  "developerBillingType": "POSTPAID",
  "organization": {
      "id": "{org_name}" 
    },
  "product": { "id": "payment" }
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments/511144db-7fb1-4c74-bafb-5bc7a6380c9c" \
-u email:password

Xóa điều chỉnh thanh toán bằng cách sử dụng API

Bạn có thể xóa điều chỉnh thanh toán bằng cách gửi yêu cầu DELETE cho /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}, trong đó {billing_adjustment_id} là mã nhận dạng điều chỉnh thanh toán sẽ đã bị xoá. Ví dụ:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments/511144db-7fb1-4c74-bafb-5bc7a6380c9c" \
-u email:password

Chế độ cài đặt cấu hình điều chỉnh thanh toán cho API

Các lựa chọn cấu hình sau đây có sẵn cho việc điều chỉnh thanh toán:

Các bước tiếp theo

Tính năng kiếm tiền giúp bạn linh hoạt trong việc cấp tín dụng cho nhà phát triển. Có thể bạn cần phải điều này nếu nhà phát triển không hài lòng với một dịch vụ và yêu cầu hoàn lại một phần hoặc toàn bộ tiền cho việc sử dụng trong một khoảng thời gian. Tìm hiểu cách cấp tín dụng trong phần Cấp tín dụng.