จัดการยอดคงเหลือในบัญชีชำระล่วงหน้า

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

คุณดำเนินการต่อไปนี้เพื่อจัดการยอดคงเหลือในบัญชีแบบชำระล่วงหน้าได้

ฉันจะคำนวณยอดเงินคงเหลือของบัญชีแบบชำระล่วงหน้าได้อย่างไร

เมื่อดูยอดเงินคงเหลือในบัญชีชำระล่วงหน้าของนักพัฒนาแอปหรือบริษัทตามที่อธิบายไว้ในส่วนต่อไปนี้ รับค่าต่อไปนี้จากการตอบกลับ

  • amount: จำนวนเงินทั้งหมดที่ใช้ได้สำหรับช่วงเวลาที่เรียกเก็บเงินปัจจุบัน ระบบจะอัปเดตค่านี้เมื่อคุณโหลดซ้ำ บัญชีแบบชำระล่วงหน้าดังกล่าวโดยใช้วิธีการที่อธิบายไว้ในส่วนนี้
  • usage: จำนวนเงินทั้งหมดที่ใช้ในระหว่างช่วงเวลาที่เรียกเก็บเงินปัจจุบัน ระบบจะอัปเดตค่านี้ด้วยการสร้างรายได้ที่เข้าเกณฑ์แต่ละรายการ ธุรกรรมหรือโดยการออกเครดิต (บวกหรือติดลบ)

คุณสามารถดู ยอดเงินคงเหลือในบัญชีชำระล่วงหน้าที่เหลือสำหรับช่วงเวลาที่เรียกเก็บเงินปัจจุบัน โดยลบค่า usage ออกจาก amount ตัวอย่างเช่น หากค่า amount คือ 335.50 และค่า usage คือ 34 ค่า ยอดเงินคงเหลือคำนวณได้ดังนี้

amount(335.50) - usage(34) = 229.50

การดูยอดคงเหลือในบัญชีชำระล่วงหน้าโดยใช้ API

ส่วนต่อไปนี้อธิบายวิธีดูเงินคงเหลือในบัญชีชำระล่วงหน้าของนักพัฒนาซอฟต์แวร์ หรือ โดยใช้ API

การดูยอดคงเหลือในบัญชีชำระล่วงหน้าสำหรับนักพัฒนาซอฟต์แวร์

หากต้องการดูเงินคงเหลือของนักพัฒนาซอฟต์แวร์ ให้ส่งคำขอ GET ไปยัง API รายการใดรายการหนึ่งต่อไปนี้ โดย {developer_id} คืออีเมลของนักพัฒนาแอป

  • /mint/organizations/{org_name}/developers/{developer_id}/developer-balances: ส่งคืนเงินคงเหลือในบัญชีชำระล่วงหน้าและข้อมูลการตั้งค่าที่เกิดซ้ำสำหรับนักพัฒนาซอฟต์แวร์
  • /mint/organizations/{org_name}/developers/{developer_id}/prepaid-developer-balances: ส่งคืนข้อมูลยอดเงินคงเหลือในบัญชีชำระล่วงหน้า รวมถึง ยอดคงเหลือปัจจุบันและยอดคงเหลือทั้งหมด การใช้งาน การเติมเงิน และภาษีการใช้งาน

คุณสามารถส่งพารามิเตอร์การค้นหาต่อไปนี้เพื่อกรองผลลัพธ์ได้

พารามิเตอร์การค้นหา คำอธิบาย
all แฟล็กที่ระบุว่าจะแสดงผลแพ็กเกจ API ทั้งหมดหรือไม่ หากตั้งค่าเป็น false จำนวนแพ็กเกจ API ที่แสดงผลต่อหน้าเว็บคือ กำหนดโดยพารามิเตอร์การค้นหา size ค่าเริ่มต้นคือ false
size จำนวนแพ็กเกจ API ที่แสดงผลต่อ 1 หน้า ค่าเริ่มต้นคือ 20 หากคำค้นหา all พารามิเตอร์ได้รับการตั้งค่าเป็น true พารามิเตอร์นี้จะถูกละเว้น
page จำนวนหน้าที่คุณต้องการแสดงผล (หากเนื้อหามีการแบ่งหน้า) ถ้า พารามิเตอร์การค้นหา all ได้รับการตั้งค่าเป็น true ระบบจะไม่สนใจพารามิเตอร์
currencyId รหัสของสกุลเงินที่ต้องการดูยอดคงเหลือในบัญชีชำระล่วงหน้า

เช่น

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

ตัวอย่างคําตอบมีดังนี้

{
    "developerBalance": [
        {
            "amount": 2005,
            "chargePerUsage": false,
            "id": "your-provider-id",
            "isRecurring": false,
            "supportedCurrency": {
                "description": "United States Dollars",
                "displayName": "United States Dollars",
                "id": "usd",
                "name": "USD",
                "organization": {
                    "address": [
                        {
                            "address1": "10 Almaden Blvd.",
                            "city": "San Jose",
                            "country": "US",
                            "id": "32e808d8-3a3c-4d76-a0ae-17d70a982c61",
                            "isPrimary": true,
                            "state": "CA",
                            "zip": "95113"
                        }
                    ],
                    "approveTrusted": false,
                    "approveUntrusted": false,
                    "billingCycle": "CALENDAR_MONTH",
                    "country": "US",
                    "currency": "USD",
                    "description": "my-org",
                    "groupOrganization": false,
                    "hasBillingAdjustment": false,
                    "hasBroker": false,
                    "hasSelfBilling": false,
                    "hasSeparateInvoiceForProduct": false,
                    "id": "my-org",
                    "issueNettingStmt": false,
                    "name": "my-org",
                    "nettingStmtPerCurrency": false,
                    "selfBillingAsExchOrg": false,
                    "selfBillingForAllDev": false,
                    "separateInvoiceForFees": false,
                    "status": "ACTIVE",
                    "supportedBillingType": "BOTH",
                    "taxModel": "HYBRID",
                    "timezone": "UTC"
                },
                "status": "ACTIVE",
                "virtualCurrency": false
            },
            "usage": 2.1572
        }
    ],
    "totalRecords": 1
}

การดูยอดคงเหลือในบัญชีชำระล่วงหน้าของบริษัท

หากต้องการดูยอดเงินคงเหลือในบัญชีชำระล่วงหน้าของบริษัท ให้ส่งคำขอ GET ไปยัง /mint/organizations/{org_name}/companies/{company_id}/developer-balances โดยที่ {company_id} คือรหัสของบริษัท ถ้าเป็นบริษัทแบบชำระล่วงหน้า คำขอ จะดึงยอดเงินคงเหลือปัจจุบันของบัญชีที่ชำระล่วงหน้า ถ้าบริษัทเป็นแบบชำระภายหลัง คำขอจะเรียกคืน วงเงินเครดิตปัจจุบัน

คุณสามารถส่งพารามิเตอร์การค้นหาต่อไปนี้เพื่อกรองผลลัพธ์ได้

พารามิเตอร์การค้นหา คำอธิบาย
all แฟล็กที่ระบุว่าจะแสดงผลแพ็กเกจ API ทั้งหมดหรือไม่ หากตั้งค่าเป็น false จำนวนแพ็กเกจ API ที่แสดงผลต่อหน้าเว็บคือ กำหนดโดยพารามิเตอร์การค้นหา size ค่าเริ่มต้นคือ false
size จำนวนแพ็กเกจ API ที่แสดงผลต่อ 1 หน้า ค่าเริ่มต้นคือ 20 หากคำค้นหา all พารามิเตอร์ได้รับการตั้งค่าเป็น true พารามิเตอร์นี้จะถูกละเว้น
page จำนวนหน้าที่คุณต้องการแสดงผล (หากเนื้อหามีการแบ่งหน้า) ถ้า พารามิเตอร์การค้นหา all ได้รับการตั้งค่าเป็น true ระบบจะไม่สนใจพารามิเตอร์
currencyId รหัสของสกุลเงินที่ต้องการดูยอดคงเหลือในบัญชีชำระล่วงหน้า

เช่น

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

การตอบกลับจะคล้ายกับการตอบกลับที่แสดงข้างต้น เมื่อดูยอดเงินคงเหลือในบัญชีชำระล่วงหน้าสำหรับ นักพัฒนาซอฟต์แวร์