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

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

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

• ดูยอดคงเหลือปัจจุบันของบัญชีแบบชำระล่วงหน้า ดูการดูยอดคงเหลือในบัญชีแบบชำระเงินล่วงหน้าโดยใช้ API
• เติมเงิน (เพิ่มเงิน) ยอดคงเหลือในบัญชีตามที่จำเป็นโดยใช้ผู้ให้บริการชำระเงินบุคคลที่สาม เช่น Worldpay โปรดดูการจัดการยอดคงเหลือแบบชำระเงินล่วงหน้าโดยใช้ผู้ให้บริการการชำระเงินบุคคลที่สาม

  หรือจะจัดการการโหลดซ้ำโดยติดตามการชําระเงินด้วยตนเองหรือผ่านระบบการเรียกเก็บเงินที่ผสานรวมไว้ แล้วเรียกใช้ API การสร้างรายได้เพื่อโหลดบัญชีซ้ำก็ได้ ตามที่อธิบายไว้ในการจัดการยอดคงเหลือแบบชําระล่วงหน้าด้วยตนเอง

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

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

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

• 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: แสดงข้อมูลยอดคงเหลือในบัญชีแบบชำระล่วงหน้า ซึ่งรวมถึงยอดคงเหลือปัจจุบันและยอดคงเหลือทั้งหมด การใช้งาน การเติมเงิน และภาษีการใช้งาน

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

เช่น

$ 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} คือรหัสของบริษัท หากบริษัทเป็นแบบชำระเงินล่วงหน้า คำขอจะดึงข้อมูลยอดคงเหลือในบัญชีแบบชำระเงินล่วงหน้าปัจจุบัน หากบริษัทเป็นแบบชําระเงินหลังได้รับสินค้า คําขอจะดึงข้อมูลวงเงินเครดิตปัจจุบัน

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

เช่น

$ 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

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

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

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

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

{
    "isRecurring": "false",
    "orderCode": "1234",
    "referenceId": "3042815493",
    "referenceUrl": "https://secure.worldpay.com/wcc/dispatcher?OrderKey=MERCH_CODE_FROM_PROVIDER%5E1234",
    "success": "true"
}

ส่วนต่อไปนี้จะอธิบายขั้นตอนที่จำเป็นในการจัดการยอดคงเหลือการชำระเงินล่วงหน้าโดยใช้ผู้ให้บริการชำระเงินบุคคลที่สาม

• การตั้งค่าบัญชีผู้ขายกับผู้ให้บริการชำระเงิน Worldpay
• การกำหนดค่าผู้ให้บริการชำระเงินใน Edge
• การดูผู้ให้บริการชำระเงินที่กำหนดค่าไว้สำหรับองค์กร
• การเปิดใช้และกําหนดค่าโมดูลที่จําเป็นในพอร์ทัลนักพัฒนาซอฟต์แวร์
• การเริ่มชำระเงินไปยังบัญชีที่ชำระล่วงหน้าโดยใช้ผู้ให้บริการชำระเงิน
• การเติมยอดคงเหลือในบัญชีแบบชำระเงินล่วงหน้าโดยใช้ API
• การลบผู้ให้บริการการชำระเงินบุคคลที่สาม

การตั้งค่าบัญชีผู้ขายกับผู้ให้บริการชำระเงิน Worldpay

ก่อนเริ่มต้น คุณต้องติดต่อผู้ให้บริการชำระเงินบุคคลที่สาม (Worldpay) เพื่อตั้งค่าบัญชีผู้ขาย เราขอแนะนำให้คุณสร้างบัญชี 2 บัญชี บัญชีหนึ่งสำหรับการทดสอบและอีกบัญชีสำหรับการใช้งานจริง ดูข้อมูลเพิ่มเติมเกี่ยวกับบัญชีผู้ขายของ Worldpay ได้ที่ www.worldpay.com และ wp-support.crm.worldpay.com (ศูนย์สนับสนุนของ Worldpay)

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

1. ไปที่ https://secure.worldpay.com/sso/public/auth/login.html
2. เข้าสู่ระบบบัญชี Worldpay โดยใช้ข้อมูลเข้าสู่ระบบที่ Worldpay มอบให้
3. ตั้งค่ารหัสผ่าน XML และคีย์ลับของรหัสการตรวจสอบสิทธิ์ข้อความ (MAC) โดยทำดังนี้
   1. คลิกโปรไฟล์
   2. ตั้งรหัสผ่านที่จะใช้เมื่อกำหนดค่าผู้ให้บริการชำระเงิน Worldpay ใน Edge ในช่องรหัสผ่าน XML
   3. ป้อนคีย์ข้อมูลลับของ MAC ยาว 20 ถึง 30 อักขระในช่องข้อมูลลับของ MAC สำหรับเปลี่ยนเส้นทาง
   4. คลิกบันทึกโปรไฟล์
4. เพิ่มเซิร์ฟเวอร์การจัดการ Apigee Edge ลงในรายการ IP ของผู้ขาย (รายการที่อนุญาต) โดยทำดังนี้
   1. คลิกโปรไฟล์ > สภาพแวดล้อมของผู้ขาย
   2. คลิกIP ทดสอบใหม่
   3. ป้อน IP ของเซิร์ฟเวอร์การจัดการ Apigee Edge
   4. คลิกบันทึก
5. กำหนดค่า URL ของผู้ขายเพื่อต่อท้ายพารามิเตอร์ Worldpay รวมถึงรหัสการตรวจสอบสิทธิ์ของวิธีการ (MAC) ดังนี้
   1. คลิกการติดตั้ง > หน้าชำระเงินที่โฮสต์ > เครื่องมือออกแบบหน้าชำระเงิน
   2. ในส่วนแก้ไขหน้าชำระเงิน ให้เลือกรหัสการติดตั้งจากรายการแบบเลื่อนลงเลือกช่องทาง
   3. ในแท็บพร็อพเพอร์ตี้ ให้เลือกแก้ไขการกำหนดค่าผู้ขาย
   4. ตั้งค่าพารามิเตอร์ Send URL เป็น True
   5. คลิกแท็บเผยแพร่
   6. โปรโมตการเปลี่ยนแปลง ดังนี้
      • สำหรับสภาพแวดล้อมการทดสอบ ให้คลิกโปรโมตในส่วนการออกแบบเพื่อโปรโมตจากการออกแบบเป็นแซนด์บ็อกซ์
      • สำหรับสภาพแวดล้อมของการใช้งานจริง ให้คลิกโปรโมตใต้แซนด์บ็อกซ์เพื่อโปรโมตจากแซนด์บ็อกซ์ไปเป็นเวอร์ชันที่ใช้งานจริง

การกำหนดค่าผู้ให้บริการชำระเงินใน Edge

ขั้นตอนถัดไปคือการกำหนดค่าผู้ให้บริการชำระเงินใน Edge

คุณกำหนดค่าผู้ให้บริการชำระเงินสำหรับองค์กรที่เฉพาะเจาะจงได้โดยใช้ API ต่อไปนี้

/organizations/{org-name}/providers

ลูกค้า Apigee Edge Private Cloud เท่านั้นที่มีสิทธิ์ผู้ดูแลระบบระบบสามารถกำหนดค่าผู้ให้บริการชำระเงินทั่วโลกได้โดยใช้ API ต่อไปนี้ (ไม่บังคับ)

/config/providers

เมื่อเรียกใช้ API แต่ละรายการ คุณต้องระบุข้อมูลต่อไปนี้ในเนื้อหาคำขอ

ตัวอย่างเช่น การตั้งค่าบัญชีผู้ขายกับ Worldpay ที่มีชื่อว่า Worldpay-myorg

$ curl  -H "Content-Type:application/json" -X POST -d \
'{
    "name": "Worldpay-myorg",
    "description": "Worldpay payment provider",
    "endpoint": "https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "authType": "123456",
    "credential": "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "merchantCode": "myMerchantCode"
  }' \
"https://api.enterprise.apigee.com/v1/organizations/myOrg/providers" \
-u email:password 

การดูผู้ให้บริการชำระเงินบุคคลที่สาม

ดูและยืนยันผู้ให้บริการการชำระเงินบุคคลที่สามที่กำหนดค่าไว้สำหรับองค์กร Edge โดยส่งคำขอ GET ไปยังทรัพยากรต่อไปนี้

/mint/organizations/{org-name}/providers

ตัวอย่างเช่น ข้อมูลต่อไปนี้แสดงผู้ให้บริการชำระเงินบุคคลที่สามที่กําหนดค่าไว้สําหรับ myorg ในปัจจุบัน

$ curl  -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/providers" \
-u email:password

ต่อไปนี้เป็นตัวอย่างการตอบกลับที่แสดงบัญชีผู้ขาย 2 บัญชี บัญชีหนึ่งสำหรับการทดสอบและอีกบัญชีสำหรับการใช้งานจริง

{
  "provider" : [ {
    "authType" : "123456",
    "credential" : "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "description" : "Worldpay payment provider",
    "endpoint" : "https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "id" : "worldpay-myorg",
    "merchantCode" : "MERCH_CODE",
    "name" : "Worldpay-myorg"
  }, {
    "authType" : "123456",
    "credential" : "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "description" : "Worldpay payment provider",
    "endpoint" : "https://secure-test.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "id" : "worldpay-test",
    "merchantCode" : "MERCH_CODE_FROM_PROVIDER",
    "name" : "Worldpay-test"
  } ]
}

การเปิดใช้และกำหนดค่าโมดูลการสร้างรายได้และ Worldpay ในพอร์ทัลนักพัฒนาซอฟต์แวร์

เปิดใช้โมดูลการสร้างรายได้และ Worldpay ที่จำเป็นในพอร์ทัลนักพัฒนาแอป โปรดดูรายละเอียดที่หัวข้อกำหนดค่าการสร้างรายได้ในพอร์ทัลนักพัฒนาแอป

เริ่มการชำระเงินไปยังบัญชีที่ชำระเงินล่วงหน้าโดยใช้ผู้ให้บริการชำระเงิน

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

• ยอมรับแพ็กเกจราคา แต่มีเงินในบัญชีแบบชำระล่วงหน้าไม่เพียงพอ
• ขอเพิ่มเงินลงในบัญชีแบบชำระเงินล่วงหน้า

หากต้องการเริ่มการชำระเงินจากผู้ให้บริการชำระเงินบุคคลที่สามโดยใช้ API ให้ส่งคำขอ POST ไปยังแหล่งข้อมูลต่อไปนี้ โดยที่ {developer_id} คืออีเมลของนักพัฒนาแอป

/mint/organizations/{org_name}/developers/{developer_id}/payment?amount={amount}&provider={providerId}&supportedCurrencyId={currency}

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

• จำนวนเงินที่จะเพิ่มลงในยอดคงเหลือของบัญชีแบบเติมเงิน (amount={amount})
• รหัสผู้ให้บริการชำระเงิน (provider={providerId})
• สกุลเงินที่รองรับ (supportedCurrencyId={currency})

นอกจากนี้ คุณจะต้องส่งรายละเอียดบัญชีพื้นฐาน เช่น ที่อยู่สําหรับการเรียกเก็บเงินของบริษัท

ตัวอย่างเช่น ข้อมูลต่อไปนี้จะเติมเงินคงเหลือในบัญชีแบบชำระล่วงหน้าโดยใช้ผู้ให้บริการชำระเงิน Worldpay การโอนเงินครั้งแรกไปยังบัญชีแบบชำระเงินล่วงหน้าจะเป็น 10 ดอลลาร์สหรัฐ (amount มีการกําหนดพารามิเตอร์การค้นหาเป็น 10)

$ curl  -H "Content-Type:application/xml" -X POST -d \
'{
    "address1": "5115 Hopyard Ave.",
    "city": "Pleasanton",
    "country": "US",
    "state": "CA",
    "zip": "58158"
}'
' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/payment?amount=10&provider=worldpay-myorg&supportedCurrencyId=usd" \
-u email:password

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

{
    "isRecurring": "false",
    "orderCode": "1234",
    "referenceId": "3042815493",
    "referenceUrl": "https://secure.worldpay.com/wcc/dispatcher?OrderKey=MERCH_CODE_FROM_PROVIDER%5E1234",
    "success": "true"
}

ระบบจะแสดง URL ของหน้าการชำระเงินที่ปลอดภัยของ Worldpay ใน referenceUrl โดยมีคีย์คำสั่งซื้อที่ไม่ซ้ำกันต่อท้ายเป็นพารามิเตอร์การค้นหา

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

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

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

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

หากต้องการเพิ่มยอดคงเหลือในบัญชีแบบชำระเงินล่วงหน้าให้กับนักพัฒนาแอปที่ใช้ API ให้ส่งคำขอ POST ไปยัง /mint/organizations/{org_name}/developers/{developer_id}/developer-balances โดยที่ {developer_id} คืออีเมลของนักพัฒนาแอป เมื่อส่งคําขอ คุณต้องระบุจํานวนเงินที่จะเพิ่มลงในยอดคงเหลือและสกุลเงินที่ใช้ในเนื้อหาคำขอ

ตัวอย่างเช่น คำขอต่อไปนี้จะเพิ่มยอดคงเหลือในบัญชีแบบชำระเงินล่วงหน้าของนักพัฒนาแอปเป็น $1, 000

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "amount": 1000,
  "supportedCurrency": {
      "id": "usd" 
  } 
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

โปรดดูรายละเอียดพร็อพเพอร์ตี้คำขอในสรุปพร็อพเพอร์ตี้คำขอสำหรับการโหลดบัญชีแบบชำระล่วงหน้าซ้ำ

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

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

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

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "amount": 1000,
  "supportedCurrency": {
      "id": "usd" 
  } 
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

ดูคำอธิบายของพร็อพเพอร์ตี้คำขอได้ที่สรุปพร็อพเพอร์ตี้คำขอสำหรับการโหลดเงินเข้าบัญชีแบบเติมเงินอีกครั้ง

สรุปพร็อพเพอร์ตี้คำขอสำหรับการโหลดเงินเข้าบัญชีแบบชำระเงินล่วงหน้าอีกครั้ง

ต้องระบุพร็อพเพอร์ตี้ต่อไปนี้เมื่อโหลดยอดคงเหลือที่ชำระล่วงหน้าโดยใช้ API ซ้ำ

การลบผู้ให้บริการชำระเงินบุคคลที่สาม

คุณสามารถลบผู้ให้บริการชำระเงินบุคคลที่สามที่กำหนดค่าไว้สำหรับองค์กร Edge ได้โดยส่งคำขอ DELETE ไปยังทรัพยากรต่อไปนี้

หากต้องการลบผู้ให้บริการชำระเงินสำหรับองค์กรที่เฉพาะเจาะจง ให้ใช้ API ต่อไปนี้

/mint/organizations/{org-name}/providers/id

ลูกค้า Apigee Edge Private Cloud เท่านั้นที่มีสิทธิ์ผู้ดูแลระบบระบบจะลบผู้ให้บริการชำระเงินทั่วโลกได้โดยใช้ API ต่อไปนี้ (ไม่บังคับ)

/config/providers/id

ตัวอย่างเช่น คำสั่งต่อไปนี้จะลบผู้ให้บริการชำระเงินบุคคลที่สามที่กําหนดค่าไว้สําหรับ myorg ในปัจจุบัน

$ curl  -X DELETE \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/providers/worldpay-myorg" \
-u email:password

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

หรือคุณสามารถจัดการการโหลดยอดคงเหลือแบบชำระล่วงหน้าซ้ำได้โดยติดตามการชำระเงินด้วยตนเองหรือผ่านระบบการเรียกเก็บเงินแบบผสานรวม แล้วเรียกใช้ API การสร้างรายได้เพื่อโหลดบัญชีซ้ำตามที่อธิบายไว้ในการโหลดเงินคงเหลือซ้ำในบัญชีแบบชำระล่วงหน้าโดยใช้ API

ตั้งค่าการโหลดเงินคงเหลือซ้ำโดยอัตโนมัติโดยใช้ API

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

การตั้งค่าการโหลดเงินคงเหลือแบบชำระล่วงหน้าโดยอัตโนมัติให้กับนักพัฒนาแอป

หากต้องการตั้งค่าการโหลดยอดคงเหลือในบัญชีแบบชำระเงินล่วงหน้าของนักพัฒนาแอปโดยอัตโนมัติเมื่อยอดคงเหลือลดลงต่ำกว่าเกณฑ์ที่กำหนด ให้ส่งคำขอ POST ไปยัง /mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup โดยที่ {developer_id} คืออีเมลของนักพัฒนาแอป

เมื่อส่งคำขอ คุณต้องระบุข้อมูลต่อไปนี้

• รหัสของผู้ให้บริการชำระเงินที่จะใช้เพื่อโหลดเงินเข้าบัญชีอีกครั้ง (providerID)
• Flag ที่เปิดใช้การโหลดซ้ำอัตโนมัติ (isRecurring)
• เกณฑ์ที่ว่ายอดเงินในบัญชีชำระล่วงหน้าจะต้องลดลงด้านล่างเพื่อเรียกใช้การโหลดซ้ำอัตโนมัติ (replenishAmount)
• จำนวนเงินที่จะเพิ่มลงในบัญชีโดยอัตโนมัติ (recurringAmount)
• พารามิเตอร์การค้นหาของ supportedCurrencyID เพื่อระบุสกุลเงิน

ในตัวอย่างต่อไปนี้ เมื่อยอดคงเหลือในบัญชีแบบชำระเงินล่วงหน้าของนักพัฒนาแอปลดลงต่ำกว่า 500 บาท ระบบจะเพิ่มเงินอีก 1,000 บาทลงในบัญชีโดยอัตโนมัติ

$ curl -H "Content-Type:application/json" -X POST -d \
'{
    "providerId": "worldpay-myorg",
    "isRecurring" : true,
    "replenishAmount" : 5,
    "recurringAmount" : 10
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup?supportedCurrencyId=usd" \
-u email:password

ดูคำอธิบายของพร็อพเพอร์ตี้คำขอได้ที่สรุปพร็อพเพอร์ตี้คำขอสำหรับการตั้งค่าการโหลดเงินเข้าบัญชีแบบเติมเงินโดยอัตโนมัติ

การตั้งค่าการโหลดยอดคงเหลือในบัญชีแบบชำระเงินล่วงหน้าขององค์กรโดยอัตโนมัติ

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

เมื่อส่งคำขอ คุณต้องระบุข้อมูลต่อไปนี้

• รหัสของผู้ให้บริการชำระเงินที่จะใช้ในการโหลดบัญชีซ้ำ (providerID)
• Flag that enables automatic reload (isRecurring)
• เกณฑ์ที่ยอดคงเหลือในบัญชีแบบชำระเงินล่วงหน้าต้องลดลงต่ำกว่าเพื่อทริกเกอร์การโหลดเงินอัตโนมัติ (replenishAmount)
• จำนวนเงินที่จะเพิ่มลงในบัญชีโดยอัตโนมัติ (recurringAmount)
• พารามิเตอร์การค้นหา supportedCurrencyID เพื่อระบุสกุลเงิน

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

$ curl -H "Content-Type:application/json" -X POST -d \
'{
    "providerId": "worldpay-myorg",
    "isRecurring" : true,
    "replenishAmount" : 5,
    "recurringAmount" : 10
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances/recurring-setup?supportedCurrencyId=usd" \
-u email:password

โปรดดูรายละเอียดพร็อพเพอร์ตี้คำขอในสรุปพร็อพเพอร์ตี้คำขอสำหรับการตั้งค่าการโหลดซ้ำบัญชีแบบชำระล่วงหน้าโดยอัตโนมัติ

สรุปพร็อพเพอร์ตี้คำขอสำหรับการตั้งค่าการโหลดบัญชีแบบชําระเงินล่วงหน้าซ้ำโดยอัตโนมัติ

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

การย้ายข้อมูลไปยังหน้าการชำระเงินที่โฮสต์ของ WorldPay

WorldPay ได้อัปเดตขั้นตอนการประมวลผลการชำระเงินที่ปลอดภัยเพื่อใช้หน้าเว็บชุดใหม่ที่เรียกว่าหน้าการชำระเงินที่โฮสต์

หากคุณกำหนดค่าผู้ให้บริการชำระเงิน WorldPay โดยใช้ขั้นตอนการประมวลผลการชำระเงินที่ปลอดภัยซึ่งเลิกใช้งานแล้ว (ก่อนเดือนสิงหาคม 2017) คุณจะต้องย้ายข้อมูลไปยังหน้าชำระเงินโฮสต์ใหม่ของ WorldPay ก่อนเดือนมกราคม 2018

วิธีย้ายข้อมูลไปยังหน้าการชำระเงินที่โฮสต์ของ WorldPay

1. ติดต่อ WorldPay เพื่อย้ายข้อมูลบัญชีปัจจุบันของคุณให้ใช้หน้าชำระเงินโฮสต์ใหม่และรับรหัสการติดตั้งใหม่สำหรับบัญชี
2. กำหนดค่าผู้ให้บริการชำระเงิน WorldPay ใหม่ตามที่อธิบายไว้ในการกำหนดค่าผู้ให้บริการชำระเงินใน Edge โดยส่งรหัสการติดตั้งในช่อง authType
3. กำหนดค่าผู้ให้บริการชำระเงินรายใหม่ในพอร์ทัลนักพัฒนาแอป ตามที่อธิบายไว้ในกำหนดค่าการสร้างรายได้ในพอร์ทัลนักพัฒนาแอป
4. หากตั้งค่าการโหลดซ้ำอัตโนมัติของบัญชีแบบชำระเงินล่วงหน้าโดยใช้ผู้ให้บริการชำระเงิน คุณต้องกำหนดค่าการโหลดซ้ำอัตโนมัติอีกครั้งเพื่อใช้รหัสผู้ให้บริการใหม่ ตามที่อธิบายไว้ในการตั้งค่าการเติมเงินซ้ำโดยอัตโนมัติของยอดเงินคงเหลือในบัญชีแบบชำระล่วงหน้าโดยใช้ API

ขั้นตอนถัดไป

คุณสามารถตั้งวงเงินเครดิตสำหรับนักพัฒนาซอฟต์แวร์แบบชำระเงินภายหลังแต่ละรายได้ ดูวิธีได้ที่จัดการยอดค้างชำระ