จัดการสกุลเงินที่รองรับ

คุณกําลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

บทนำ

ทีมการกําหนดค่า Apigee Edge จะกําหนดค่าสกุลเงินและสกุลเงินเริ่มต้นที่องค์กรของคุณรองรับ ซึ่งเป็นส่วนหนึ่งของการตั้งค่าการสร้างรายได้เริ่มต้น

คุณสามารถดูสกุลเงินที่องค์กรรองรับ เพิ่มสกุลเงินที่รองรับ หรือลบสกุลเงินที่รองรับ (หากนักพัฒนาแอปหรือแพ็กเกจราคาไม่ได้ใช้สกุลเงินนั้น)

การจัดการสกุลเงินที่รองรับโดยใช้ UI

จัดการสกุลเงินที่รองรับและตั้งค่าสกุลเงินเริ่มต้นในส่วนภาษีและสกุลเงินของหน้าโปรไฟล์องค์กร ดูรายละเอียดที่หัวข้อการจัดการโปรไฟล์องค์กรโดยใช้ UI

การจัดการสกุลเงินที่รองรับโดยใช้ API

จัดการสกุลเงินที่รองรับโดยใช้ API ตามที่อธิบายไว้ในส่วนต่อไปนี้

การดูสกุลเงินที่รองรับโดยใช้ API

ดูสกุลเงินแต่ละสกุลที่องค์กรรองรับหรือสกุลเงินทั้งหมดที่องค์กรรองรับ

หากต้องการดูสกุลเงินแต่ละสกุลที่องค์กรของคุณรองรับ ให้ส่งคำขอ GET ไปยัง /mint/organizations/{org_name}/supported-currencies/{supportedCurrencyId} โดยที่ {supportedCurrency_id} คือรหัสสกุลเงินที่รองรับซึ่งต้องการดู เช่น

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

หากต้องการดูสกุลเงินทั้งหมดที่องค์กรของคุณรองรับ ให้ส่งคำขอ GET ไปยัง /mint/organizations/{org_name}/supported-currencies เช่น

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

ต่อไปนี้เป็นตัวอย่างการตอบกลับ

{
"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
}

การเพิ่มสกุลเงินที่รองรับโดยใช้ API

เพิ่มสกุลเงินที่รองรับโดยการส่งคำขอ POST ไปยัง /mint//organizations/{org_name}/supported-currencies สําหรับสกุลเงินที่รองรับแต่ละรายการที่คุณเพิ่ม คุณจะต้องระบุข้อมูลต่อไปนี้ในเนื้อหาคําขอ

• ชื่อสกุลเงินที่รองรับ ชื่อคือรหัส ISO 4217 ของสกุลเงิน เช่น USD สำหรับดอลลาร์สหรัฐ
• ชื่อที่แสดง
• คำอธิบาย
• สกุลเงินเป็นสกุลเงินเสมือนหรือไม่
• สถานะของสกุลเงิน ซึ่งก็คือสกุลเงินพร้อมใช้งานหรือไม่
• องค์กรที่จะเพิ่มสกุลเงินที่รองรับ

คุณเลือกตั้งค่าต่อไปนี้ได้

• วงเงินเครดิตสำหรับสกุลเงินที่รองรับ (นักพัฒนาแอปแบบชําระเงินตามหลังเท่านั้น)
• การเติมเงินขั้นต่ำสำหรับสกุลเงินที่รองรับ (นักพัฒนาแอปแบบชำระเงินล่วงหน้าเท่านั้น)

ดูข้อมูลเพิ่มเติมได้ที่พร็อพเพอร์ตี้การกําหนดค่าสกุลเงินที่รองรับ

ตัวอย่างเช่น คำสั่งต่อไปนี้จะเพิ่มสกุลเงินที่รองรับสำหรับองค์กร

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

การตั้งค่าสกุลเงินเริ่มต้นโดยใช้ API

กำหนดสกุลเงินเริ่มต้นสำหรับองค์กรโดยตั้งค่า currency เป็นรหัสสกุลเงินตามมาตรฐาน ISO 4217 ที่รองรับเมื่อคุณแก้ไขโปรไฟล์องค์กร ตามที่อธิบายไว้ในการจัดการโปรไฟล์องค์กรโดยใช้ API

การแก้ไขสกุลเงินที่รองรับโดยใช้ API

แก้ไขสกุลเงินที่รองรับโดยการออกคำขอ PUT ไปยัง /mint/organizations/{org_name}/{supportedCurrencyId} โดย {supportedCurrency_id} คือการระบุสกุลเงินที่รองรับที่จะอัปเดต คุณต้องระบุพร็อพเพอร์ตี้ที่อัปเดตแล้วและรหัสสกุลเงินที่รองรับในเนื้อหาคำขอ ตัวอย่างเช่น การเรียก API ต่อไปนี้จะแก้ไขคำอธิบายและชื่อที่แสดงสำหรับสกุลเงินที่รองรับ (ระบบจะไฮไลต์พร็อพเพอร์ตี้ที่อัปเดตแล้วในตัวอย่าง)

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

การลบสกุลเงินที่รองรับโดยใช้ API

ลบสกุลเงินที่รองรับโดยการส่งคำขอ DELETE ไปยัง /mint/organizations/{org_name}/supported-currencies/{currency_id} โดยที่ {currency_id} คือรหัสสกุลเงินที่รองรับซึ่งจะลบ เช่น

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

พร็อพเพอร์ตี้การกำหนดค่าสกุลเงินของ API

ตารางต่อไปนี้สรุปพร็อพเพอร์ตี้การกำหนดค่าที่ตั้งค่าได้โดยใช้ API

ชื่อ	คำอธิบาย	ค่าเริ่มต้น	จำเป็นหรือไม่
creditLimit	พร็อพเพอร์ตี้นี้ใช้กับนักพัฒนาแอปแบบชําระเงินภายหลังเท่านั้น วงเงินเครดิตสำหรับสกุลเงินที่รองรับ	ไม่มี	ไม่
คำอธิบาย	คำอธิบายสกุลเงินที่รองรับ	ไม่มี	ใช่
displayName	ชื่อที่จะแสดงสำหรับสกุลเงินที่รองรับ	ไม่มี	ใช่
minimumTopupAmount	พร็อพเพอร์ตี้นี้ใช้กับนักพัฒนาแอปแบบชำระเงินล่วงหน้าเท่านั้น จำนวนเงินขั้นต่ำที่นักพัฒนาแอปสามารถเพิ่มลงในยอดคงเหลือของบัญชีแบบชำระเงินล่วงหน้าในสกุลเงินที่ระบุ	ไม่มี	ไม่
ชื่อ	รหัส ISO 4217 ของสกุลเงิน เช่น USD สำหรับดอลลาร์สหรัฐ	ไม่มี	ใช่
องค์กร	องค์กรสําหรับสกุลเงินที่รองรับ	ไม่มี	ใช่
สถานะ	สถานะของสกุลเงินที่รองรับ ค่าที่ใช้ได้มีดังนี้ ใช้งานอยู่: สกุลเงินที่รองรับพร้อมให้ใช้งาน ไม่ทำงาน: สกุลเงินที่รองรับไม่พร้อมใช้งาน	ไม่มี	ใช่
virtualCurrency	ระบุว่าสกุลเงินที่รองรับเป็นสกุลเงินเสมือนหรือไม่ ค่าที่ถูกต้องประกอบด้วย true: สกุลเงินที่รองรับคือสกุลเงินเสมือน เท็จ: สกุลเงินที่รองรับไม่ใช่สกุลเงินเสมือน	ไม่มี	ใช่