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

Quản lý đơn vị tiền tệ được hỗ trợ

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

Trong quá trình thiết lập hoạt động kiếm tiền ban đầu, nhóm cấu hình Apigee Edge sẽ định cấu hình các đơn vị tiền tệ và đơn vị tiền tệ mặc định mà tổ chức của bạn hỗ trợ.

Bạn có thể xem các đơn vị tiền tệ mà tổ chức của bạn hỗ trợ, thêm đơn vị tiền tệ được hỗ trợ hoặc xoá đơn vị tiền tệ được hỗ trợ (nếu nhà phát triển hoặc gói giá không sử dụng những đơn vị tiền tệ đó).

Quản lý đơn vị tiền tệ được hỗ trợ bằng giao diện người dùng

Quản lý các đơn vị tiền tệ được hỗ trợ và đặt đơn vị tiền tệ mặc định trong phần Thuế và đơn vị tiền tệ trên trang Hồ sơ tổ chức. Hãy xem bài viết Quản lý hồ sơ của tổ chức bằng giao diện người dùng để biết thông tin chi tiết.

Quản lý đơn vị tiền tệ được hỗ trợ bằng API

Quản lý đơn vị tiền tệ được hỗ trợ bằng API, như mô tả trong các phần sau.

Xem đơn vị tiền tệ được hỗ trợ bằng API

Xem một đơn vị tiền tệ riêng lẻ được tổ chức của bạn hỗ trợ hoặc tất cả đơn vị tiền tệ được tổ chức của bạn hỗ trợ.

Để xem một đơn vị tiền tệ riêng lẻ được tổ chức của bạn hỗ trợ, hãy gửi yêu cầu GET tới /mint/organizations/{org_name}/supported-currencies/{supportedCurrencyId}, trong đó {supportedCurrency_id} là giá trị nhận dạng đơn vị tiền tệ được hỗ trợ cần xem. Ví dụ:

curl -X GET -H "Accept: application/json"  \
  "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies/usd" \
-u email:password

Để xem tất cả đơn vị tiền tệ mà tổ chức của bạn hỗ trợ, hãy gửi yêu cầu GET đến /mint/organizations/{org_name}/supported-currencies. Ví dụ:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies" \
  -H "Accept: application/json"  \
-u email:password

Sau đây là ví dụ về phản hồi:

{
"supportedCurrency" : [ {
    "description" : "US Dollar",
    "displayName" : "US Dollar",
    "id" : "usd",
    "name" : "USD",
    "organization" : {
      ...
    "status" : "ACTIVE",
    "virtualCurrency" : false
  }, {
    "creditLimit" : 5000.0000,
    "description" : "Euro",
    "displayName" : "Euro",
    "id" : "eur",
    "name" : "EUR",
    "organization" : {
      ...
    },
    "status" : "INACTIVE",
    "virtualCurrency" : false  
  } ],
  "totalRecords" : 2
}

Thêm đơn vị tiền tệ được hỗ trợ bằng API

Thêm đơn vị tiền tệ được hỗ trợ bằng cách gửi yêu cầu POST tới /mint//organizations/{org_name}/supported-currencies. Đối với mỗi đơn vị tiền tệ được hỗ trợ mà bạn thêm, bạn cần chỉ định thông tin sau trong nội dung yêu cầu:

Tên đơn vị tiền tệ được hỗ trợ. Tên này mang mã ISO 4217 cho đơn vị tiền tệ, chẳng hạn như USD cho đô la Mỹ.
Tên hiển thị.
Nội dung mô tả.
Đơn vị tiền tệ có phải là tiền ảo hay không.
Trạng thái của đơn vị tiền tệ, tức là liệu đơn vị tiền tệ đó có sử dụng được hay không.
Tổ chức mà đơn vị tiền tệ được hỗ trợ sẽ được thêm vào.

Bạn có thể tuỳ ý đặt:

Hạn mức tín dụng cho một đơn vị tiền tệ được hỗ trợ (chỉ dành cho nhà phát triển trả sau).
Số tiền nạp tối thiểu cho một đơn vị tiền tệ được hỗ trợ (chỉ dành cho nhà phát triển trả trước).

Xem Các thuộc tính cấu hình đơn vị tiền tệ được hỗ trợ để biết thêm thông tin.

Ví dụ: nội dung sau đây sẽ thêm đơn vị tiền tệ được hỗ trợ cho một tổ chức:

curl -H "Content-Type: application/json" -X POST -d \
  '{
     "description": "US Dollar",
     "displayName": "US Dollar",
     "virtualCurrency": "false",
     "name": "USD",
     "organization": {
       "id": "{org_name}"
     },
     "status": "ACTIVE"
  }' \
  "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies" \
  -u email:password

Đặt đơn vị tiền tệ mặc định bằng API

Đặt đơn vị tiền tệ mặc định cho tổ chức bằng cách đặt giá trị currency thành mã đơn vị tiền tệ theo tiêu chuẩn ISO 4217 được hỗ trợ khi bạn chỉnh sửa hồ sơ tổ chức, như mô tả trong phần Quản lý hồ sơ của tổ chức bằng API.

Chỉnh sửa đơn vị tiền tệ được hỗ trợ bằng API

Chỉnh sửa đơn vị tiền tệ được hỗ trợ bằng cách gửi yêu cầu PUT cho /mint/organizations/{org_name}/{supportedCurrencyId}, trong đó {supportedCurrency_id} là giá trị nhận dạng đơn vị tiền tệ được hỗ trợ mà bạn cần cập nhật. Trong nội dung yêu cầu, bạn cần chỉ định các thuộc tính được cập nhật cũng như mã đơn vị tiền tệ được hỗ trợ. Ví dụ: lệnh gọi API sau đây chỉnh sửa nội dung mô tả và tên hiển thị cho một đơn vị tiền tệ được hỗ trợ (trong ví dụ này các thuộc tính cập nhật sẽ được làm nổi bật):

curl -H "Content-Type: application/json" -X PUT -d \
  '{
     "description": "United States Dollar",
     "displayName": "United States Dollar",
     "id": "usd",
     "name": "USD",
     "organization": {
       "id": "{org_name}"
     },
     "status" : "ACTIVE",
     "virtualCurrency": "false"
  }' \
  "https://api.enterprise.apigee.com/v1/mint/organization/{org_name}/supported-currencies/usd" -d \
  -u email:password

Xoá đơn vị tiền tệ được hỗ trợ bằng API

Xoá đơn vị tiền tệ được hỗ trợ bằng cách gửi yêu cầu DELETE cho /mint/organizations/{org_name}/supported-currencies/{currency_id}, trong đó {currency_id} là giá trị nhận dạng đơn vị tiền tệ được hỗ trợ cần xoá. Ví dụ:

curl -X DELETE -H "Accept: application/json"  \
  "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies/usd" \
  -u email:password

Thuộc tính cấu hình đơn vị tiền tệ cho API

Bảng sau đây tóm tắt các thuộc tính cấu hình có thể được thiết lập bằng API.

Tên	Nội dung mô tả	Mặc định	Bắt buộc?
creditLimit	Tài sản này chỉ áp dụng cho nhà phát triển trả sau. Hạn mức tín dụng cho đơn vị tiền tệ được hỗ trợ. Lưu ý: Nhà phát triển có thể ghi đè hạn mức tín dụng trong số dư trả sau của họ. Hãy xem phần Đặt hạn mức tín dụng bằng API.	Không áp dụng	Không
description	Nội dung mô tả đơn vị tiền tệ được hỗ trợ.	Không áp dụng	Có
displayName	Tên để hiển thị cho đơn vị tiền tệ được hỗ trợ.	Không áp dụng	Có
minimumTopupAmount	Thuộc tính này chỉ áp dụng cho nhà phát triển trả trước. Số tiền tối thiểu mà nhà phát triển có thể nạp vào số dư tài khoản trả trước bằng đơn vị tiền tệ đã chỉ định.	Không áp dụng	Không
tên	Mã ISO 4217 cho đơn vị tiền tệ, chẳng hạn như USD cho đô la Mỹ.	Không áp dụng	Có
tổ chức	Tổ chức sử dụng đơn vị tiền tệ được hỗ trợ.	Không áp dụng	Có
trạng thái	Trạng thái của đơn vị tiền tệ được hỗ trợ. Các giá trị hợp lệ bao gồm: HOẠT ĐỘNG: Hiện có đơn vị tiền tệ được hỗ trợ để sử dụng. KHÔNG HOẠT ĐỘNG: Đơn vị tiền tệ được hỗ trợ hiện không có sẵn để sử dụng.	Không áp dụng	Có
virtualCurrency	Cho biết liệu đơn vị tiền tệ được hỗ trợ có phải là tiền ảo hay không. Các giá trị hợp lệ bao gồm: true: Đơn vị tiền tệ được hỗ trợ là tiền ảo. false: Đơn vị tiền tệ được hỗ trợ không phải là tiền ảo.	Không áp dụng	Có