การให้เครดิต

คุณกำลังดูเอกสารประกอบ Apigee Edge
ไปที่ เอกสารประกอบเกี่ยวกับ Apigee X. ข้อมูล

บทนำ

การสร้างรายได้ให้ความยืดหยุ่นในการออกเครดิตนักพัฒนาแอป

สำหรับนักพัฒนาแอปแบบชำระเงินล่วงหน้า เครดิตจะปรากฏเป็นการลดการใช้งาน ซึ่งจะเพิ่มหรือลดยอดคงเหลือที่ชำระล่วงหน้าของนักพัฒนาซอฟต์แวร์ในอนาคต คล้ายกันมาก เมื่อใช้บัตรเดบิต ระบบจะถอนเงินจากยอดเติมเงินของนักพัฒนาซอฟต์แวร์เมื่อ ที่ซื้อแพ็กเกจผลิตภัณฑ์ API นักพัฒนาซอฟต์แวร์ต้องรักษายอดคงเหลือที่เพียงพอสำหรับ การซื้อ โปรดดูฉันจะคำนวณยอดเงินคงเหลือของบัญชีแบบชำระล่วงหน้าได้อย่างไร

สำหรับนักพัฒนาซอฟต์แวร์แบบชำระเงินภายหลัง เครดิตจะปรากฏเป็น อีกบรรทัดหนึ่งในใบแจ้งหนี้ ซึ่งเป็นการลดค่าบริการในใบแจ้งหนี้

การสำรวจหน้าเครดิต

เข้าถึงและสำรวจหน้าเครดิตตามที่อธิบายไว้ด้านล่าง

การออกเครดิต

1. เข้าถึงหน้าเครดิต
2. คลิก + เครดิต
3. ป้อนข้อมูลต่อไปนี้

   ช่อง	คำอธิบาย
   เดือนที่เรียกเก็บเงิน	เดือนที่เรียกเก็บเงินที่ใช้เครดิต เลือกเดือนจากรายการ
   นักพัฒนาซอฟต์แวร์	ชื่อนักพัฒนาซอฟต์แวร์หรือบริษัทที่ได้รับเครดิต ป้อนชื่อในกล่องข้อความ ขณะที่คุณพิมพ์ รายชื่อนักพัฒนาซอฟต์แวร์/บริษัทที่มีสตริงนี้จะแสดงในเมนูแบบเลื่อนลง คลิกชื่อนักพัฒนาซอฟต์แวร์หรือบริษัทจากรายการแบบเลื่อนลง หมายเหตุ: หลังจากเลือกนักพัฒนาซอฟต์แวร์หรือบริษัทแล้ว ช่องที่เหลือจะปรากฏขึ้น หากเลือกบริษัทหรือนักพัฒนาแอปที่ยังไม่ได้ยอมรับแพ็กเกจราคา คุณจะออกเครดิตไม่ได้
   แพ็กเกจผลิตภัณฑ์	แพ็กเกจผลิตภัณฑ์ API ที่ใช้เครดิต เลือกจากรายการกลุ่มผลิตภัณฑ์ API ที่พร้อมใช้งาน
   ผลิตภัณฑ์	ผลิตภัณฑ์ API ในแพ็กเกจผลิตภัณฑ์ API ที่เลือกซึ่งใช้เครดิต เลือก ผลิตภัณฑ์ทั้งหมดหรือผลิตภัณฑ์ API รายการเดียวจากรายการ
   สกุลเงิน	สกุลเงินที่ใช้สำหรับเครดิต ระบบจะกำหนดค่าสกุลเงินสำหรับแพ็กเกจราคาในแพ็กเกจผลิตภัณฑ์ API ที่ ที่นักพัฒนาซอฟต์แวร์ซื้อและไม่สามารถเปลี่ยนแปลงได้ หากมีการกำหนดหลายสกุลเงินในแพ็กเกจราคา คุณจะเลือกจากสกุลเงินใดสกุลเงินหนึ่งได้
   จำนวนเงิน	จํานวนเครดิต (ในสกุลเงินที่ระบุ) ระบุค่าบวกหรือค่าลบ ค่าต้องไม่เป็น 0
   หมายเหตุ	หมายเหตุ (ไม่บังคับ) เพื่ออธิบายเหตุผลของเครดิต

4. คลิกบันทึกเครดิต

การออกเครดิตโดยใช้ API

การใช้ API ออกเครดิตให้นักพัฒนาซอฟต์แวร์สำหรับแพ็กเกจผลิตภัณฑ์ API ทั้งหมด หรือ เทียบกับการใช้ผลิตภัณฑ์ API เฉพาะในแพ็กเกจผลิตภัณฑ์ API

หากต้องการออกเครดิตโดยใช้ API ให้ส่งคำขอ POST ไปยัง /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{rate-plan_id}/real-currency-credit-transactions, โดยที่ {package_id} และ {rate-plan_id} กำหนด การระบุแพ็กเกจผลิตภัณฑ์ API และแพ็กเกจราคาที่จะใช้เครดิตตามลำดับ

เมื่อคุณส่งคำขอ คุณต้องระบุเป็นพารามิเตอร์การค้นหาดังนี้

• รหัสนักพัฒนาซอฟต์แวร์ (อีเมล) ที่จะใช้เครดิต
• จำนวนเงินเครดิต
• สกุลเงินที่ใช้สำหรับเครดิต
• หมายเหตุที่อธิบายเหตุผลสำหรับเครดิต

นอกจากนี้ คุณยังระบุพารามิเตอร์การค้นหาเพิ่มเติมต่อไปนี้ได้ด้วย

• เดือนที่เรียกเก็บเงินที่ใช้เครดิต ค่าเริ่มต้นจะเป็นค่าปัจจุบัน เดือน
• ปีที่เรียกเก็บเงินที่จะใช้เครดิต ค่านี้จะมีค่าเริ่มต้นเป็นปีปัจจุบัน
• ผลิตภัณฑ์ API ที่ใช้เครดิต หากคุณไม่ได้ระบุผลิตภัณฑ์ API รหัส เครดิตจะใช้กับผลิตภัณฑ์ API ทั้งหมดในแพ็กเกจผลิตภัณฑ์ API

ตัวอย่างเช่น คำขอต่อไปนี้ออกเครดิตมูลค่า $100 สำหรับเดือนที่เรียกเก็บเงินของเดือนเมษายน 2018 ถึงนักพัฒนาซอฟต์แวร์ที่ระบุว่าเป็น dev1@myorg.com เครดิตจะใช้กับ payment แพ็กเกจผลิตภัณฑ์ API และแพ็กเกจราคา payment_standard_plan:

โปรดดูพารามิเตอร์การค้นหาสำหรับ Credit API เพื่อดูรายการพารามิเตอร์การค้นหาทั้งหมด ที่คุณระบุในคำขอเครดิต

$ 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

ต่อไปนี้เป็นตัวอย่างข้อความที่ตัดตอนมาจากคำตอบ

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

พารามิเตอร์การค้นหาสำหรับ Credit API

พารามิเตอร์การค้นหาต่อไปนี้ใช้ได้กับ API ของเครดิต