Phát hành tín dụ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 giúp bạn linh hoạt trong việc cấp tín dụng cho nhà phát triể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 đi. Điều này sẽ làm tăng hoặc giảm số dư trả trước của nhà phát triển trong tương lai. Tương tự như khi sử dụng thẻ ghi nợ, tiền sẽ được rút từ số dư trả trước của nhà phát triển khi nhà phát triển mua gói sản phẩm API. Nhà phát triển phải duy trì số dư đủ để thực hiện giao dịch mua. Xem bài viết Làm cách nào để tính số dư còn lại trong tài khoản trả trước?

Đố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, giúp giảm khoản phí trong hoá đơn.

Khám phá trang Thông tin ghi công

Truy cập và khám phá trang Ghi công như mô tả dưới đây.

Cấp khoản tín dụng

1. Truy cập vào trang Khoản tín dụng.
2. Nhấp vào + Ghi có.
3. Nhập thông tin dưới đây:

   Trường	Mô tả
   Tháng thanh toán	Tháng thanh toán áp dụng khoản tín dụng. Chọn một tháng trong danh sách.
   Nhà phát triển	Tên nhà phát triển hoặc công ty được ghi công. Nhập tên vào hộp văn bản. Khi bạn nhập, danh sách các nhà phát triển/công ty chứa chuỗi đó sẽ xuất hiện trong trình đơn thả xuống. Nhấp vào tên của nhà phát triển hoặc công ty trong danh sách thả xuống. Lưu ý: Sau khi bạn chọn một nhà phát triển hoặc công ty, các trường còn lại sẽ hiển thị. Nếu chọn một công ty hoặc nhà phát triển chưa chấp nhận gói giá thì bạn không thể phát hành tín dụng.
   Gói sản phẩm	Gói sản phẩm API áp dụng khoản tín dụng. Chọn trong danh sách các gói sản phẩm API hiện có.
   Sản phẩm	Sản phẩm API trong gói sản phẩm API đã chọn mà khoản tín dụng áp dụng. Chọn Tất cả sản phẩm hoặc một sản phẩm API trong danh sách.
   Đơn vị tiền tệ	Đơn vị tiền tệ dùng cho khoản tín dụng. Đơn vị tiền tệ được định cấu hình cho gói sản phẩm API mà nhà phát triển đã mua và không thể thay đổi. Nếu có nhiều đơn vị tiền tệ được xác định trong một gói giá, bạn có thể chọn một trong các đơn vị tiền tệ đó.
   Số tiền	Số tiền tín dụng (bằng đơn vị tiền tệ được chỉ định). Chỉ định một giá trị dương hoặc âm. Giá trị này không được bằng 0.
   Lưu ý	Ghi chú không bắt buộc để mô tả lý do cấp tín dụng.

4. Nhấp vào Lưu khoản tín dụng.

Cấp tín dụng bằng API

Sử dụng API để cấp tín dụng cho nhà phát triển đối với toàn bộ gói sản phẩm API hoặc đối với việc sử dụng một sản phẩm API cụ thể trong gói sản phẩm API.

Để cấp tín dụng bằng API, hãy gửi yêu cầu POST đến /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{rate-plan_id}/real-currency-credit-transactions, trong đó {package_id} và {rate-plan_id} xác định giá trị nhận dạng của gói sản phẩm API và gói cước mà khoản tín dụng áp dụng tương ứ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 nhà phát triển (địa chỉ email) được áp dụng khoản tín dụng.
• Số tiền trong khoản tín dụng.
• Đơn vị tiền tệ dùng cho khoản tín dụng.
• Ghi chú mô tả lý do cấp tín dụng.

Nếu muốn, bạn có thể chỉ định các tham số truy vấn bổ sung sau:

• Tháng thanh toán mà khoản tín dụng được áp dụng. Giá trị này mặc định là tháng hiện tại.
• Năm thanh toán áp dụng khoản tín dụng. Giá trị này mặc định là năm hiện tại.
• Sản phẩm API mà khoản tín dụng được áp dụng. Nếu bạn không chỉ định mã sản phẩm API, khoản tín dụng sẽ áp dụng cho tất cả sản phẩm API trong gói sản phẩm API.

Ví dụ: yêu cầu sau đây sẽ phát hành khoản tín dụng trị giá 100 đô la cho tháng thanh toán tháng 4 năm 2018 cho một nhà phát triển được xác định là dev1@myorg.com. Khoản tín dụng này áp dụng cho gói sản phẩm API payment và gói giá payment_standard_plan:

Hãy xem phần Tham số truy vấn cho API tín dụng để biết danh sách đầy đủ các tham số truy vấn mà bạn có thể chỉ định trong yêu cầu tín dụng.

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/rate-plans/payment_standard_plan/real-currency-credit-transactions?currencyId=usd&developerId=dev1@myorg.com&transactionAmount=100&transactionNote=Credit+for+failed+transactions&billingMonth=APRIL&billingYear=2013" \
-u email:password

Sau đây là một đoạn trích mẫu của phản hồi:

{
  "currency" : "USD",
  "developer" : {
    "address" : [ {
      "address1" : "Dev One Address",
     ...
    } ],
    "approxTaxRate" : 0.0000,
    "billingType" : "PREPAID",
    "broker" : false,
    "developerRole" : [ ],
    "email" : "dev1@myorg.com",
    "hasSelfBilling" : false,
    "id" : "K4jW2QLjZ1h8GFA8",
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
     ...
    },
    "registrationId" : "TestRegId",
    "status" : "ACTIVE",
    "type" : "TRUSTED"
  },
  "endTime" : "2013-09-04 15:54:36",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8107,
  "gbpExchangeRate" : 0.6860,
  "id" : "904c3f73-ab8d-4e5d-a48c-225fd49a3bde",
  "isVirtualCurrency" : false,
  "notes" : "Credit for failed transactions",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  "providerTxId" : "904c3f73-ab8d-4e5d-a48c-225fd49a3bde",
  "rate" : 100,
  "ratePlan" : {
    ...
      },
      "status" : "ACTIVE",
      "virtualCurrency" : false
    },
    "description" : "Standard Plan",
    "displayName" : "Standard Plan",
    …
    "monetizationPackage" : {
      "description" : "Payment",
      ...
        } ],
       ...
      },
      "product" : [ {
        "customAtt1Name" : "user",
        "description" : "Payment",
        "displayName" : "Payment",
        "id" : "payment",
        "name" : "payment",
        "organization" : {
          ...
        },
        "status" : "CREATED",
        "transactionSuccessCriteria" : "Status=='200 OK'"
      } ],
      "status" : "CREATED"
    },
    "name" : "Standard Plan",
    "organization" : {
     ...
    },
    ...
      },
      ...
      },
      ...
  },
  "revenueShareAmount" : 0,
  "startTime" : "2013-09-04 15:54:36",
  "status" : "SUCCESS",
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "CREDIT",
  "usdExchangeRate" : 1.0675,
  "utcEndTime" : "2013-09-04 15:54:36",
  "utcStartTime" : "2013-09-04 15:54:36"
}

Tham số truy vấn cho API tín dụng

Bạn có thể sử dụng các tham số truy vấn sau đây với API thông tin ghi công:

Tên	Mô tả	Mặc định	Bắt buộc?
billingMonth	Tháng thanh toán áp dụng khoản tín dụng, chẳng hạn như THÁNG 4.	Không áp dụng	Không
billingYear	Năm thanh toán áp dụng khoản tín dụng, chẳng hạn như năm 2018.	Không áp dụng	Không
currencyId	Đơn vị tiền tệ dùng cho khoản tín dụng. Đơn vị tiền tệ được định cấu hình cho gói giá trong gói sản phẩm API mà nhà phát triển đã mua và không thay đổi được.	Không áp dụng	Có
developerId	Tên nhà phát triển hoặc công ty được ghi công.	Không áp dụng	Có
productId	Sản phẩm API áp dụng khoản tín dụng. Nếu bạn không chỉ định mã sản phẩm, khoản tín dụng sẽ áp dụng cho tất cả sản phẩm API trong gói sản phẩm API.	Không áp dụng	Không
transactionAmount	Số tiền tín dụng (bằng đơn vị tiền tệ được chỉ định). Chỉ định một giá trị dương hoặc âm. Giá trị này không được bằng 0.	Không áp dụng	Có
transactionNote	Lưu ý mô tả lý do cấp tín dụng.	Không áp dụng	Có