โพสต์การคืนเงิน

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

บทนำ

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

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

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

การโพสต์เงินคืนโดยใช้ แบบคลาสสิก Edge UI (Edge สำหรับ Private Cloud เท่านั้น)

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

คุณสามารถโพสต์การคืนเงินเต็มจำนวนของธุรกรรมการซื้อครั้งแรก หรือสำหรับ บางส่วน คุณสามารถโพสต์การคืนเงินบางส่วนได้หลายรายการ แต่ยอดรวมของการคืนเงิน ต้องไม่มากกว่ายอดรวมการซื้อเดิม

วิธีโพสต์การคืนเงิน

1. ในแท็บการสร้างรายได้ ให้เลือก "การคืนเงิน"

   

   การดำเนินการนี้จะเปิดหน้าการคืนเงิน

   

2. ในเมนูแบบเลื่อนลง "เดือนที่เรียกเก็บเงิน" ให้เลือกเดือนที่มีการทำธุรกรรมการซื้อ ก็เกิดขึ้น จากนั้นคลิก + การคืนเงิน

   ซึ่งจะแสดงรายการธุรกรรมการซื้อที่สำเร็จทั้งหมดสำหรับรายการที่เลือก เดือน

   

   คุณสามารถกรองรายการคืนเงินตามชื่อนักพัฒนาซอฟต์แวร์หรือโดยการค้นหาบน ธุรกรรม

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

   

   หากต้องการกรองตามรหัสธุรกรรม ให้ป้อนรหัสธุรกรรมการซื้อเดิมที่คุณ ต้องการขอเงินคืน ซึ่งจะแสดงธุรกรรมสำหรับรหัสนั้น

   

3. เลือกช่อง "เลือก" ในแถวของธุรกรรมที่ต้องการคืนเงิน
4. เลือก ทั้งหมด หรือ บางส่วน ในเมนูแบบเลื่อนลง ประเภท

   หากเลือก "รวม" ระบบจะคืนเงินเต็มจำนวนจากการซื้อ หากคุณเลือก ระบบจะคืนเงินค่าสินค้าบางส่วนให้คุณ

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

   

5. คลิก บันทึก เพื่อดำเนินการคืนเงิน (หรือ ยกเลิก เพื่อยกเลิก)

   การคืนเงินจะโพสต์ไปยังเดือนที่ซื้อเดิมหากเดือนที่เรียกเก็บเงินยังคงอยู่ เปิด มิเช่นนั้นการคืนเงินจะโพสต์ไปยังวันที่ปัจจุบัน

   สำหรับการคืนเงินบางส่วน ระบบจะดำเนินการคืนเงินสำหรับจำนวนเงินบางส่วนและส่วนแบ่งรายได้ทั้งหมด จะถูกหักตามสัดส่วนของจำนวนเงินบางส่วนแทนที่จะเป็นจำนวนเงินทั้งหมด ใน ตัวอย่างการคืนเงินบางส่วนข้างต้น จํานวนเงินบางส่วนเท่ากับ 0.50/1.12 = 45% ของราคาขาย ดังนั้น จะมีการหักส่วนแบ่งรายได้ 45% จากส่วนแบ่งรายได้ของนักพัฒนาแอป

ตรวจสอบใน UI ว่าคืนเงินแล้ว ประมวลผลแล้ว

คุณสามารถดูว่ามีการดำเนินการคืนเงินแล้วหรือยังได้โดยเลือกเดือนที่เรียกเก็บเงินที่ด้านบนของ หน้าการคืนเงิน นี่คือเดือนที่ซื้อหากเดือนที่เรียกเก็บเงินยังเปิดอยู่ หรือ เดือนปัจจุบัน หากเดือนที่เรียกเก็บเงินปิดอยู่ ซึ่งจะแสดงรายการการคืนเงินทั้งหมดที่ โพสต์ในเดือนนั้น

การโพสต์การคืนเงินโดยใช้ API

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

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

• การระบุธุรกรรมการซื้อที่กำลังได้รับเงินคืน
• ประเภทรายได้ (GROSS หรือ NET) ของธุรกรรมการซื้อ
• จํานวนเงินคืน
• โน้ตที่อธิบายเหตุผลของการคืนเงิน

หรือคุณสามารถระบุแพ็กเกจ API ที่เป็นพารามิเตอร์ของ URL ที่มีการคืนเงิน นำไปใช้ได้

ดูรายการ URL ทั้งหมดได้ที่การตั้งค่าการกำหนดค่าการคืนเงิน ที่คุณสามารถระบุในคำขอเงินคืนได้

ตัวอย่างเช่น คำขอต่อไปนี้ออกเงินคืนสำหรับธุรกรรมการซื้อ การคืนเงิน คือ 50% ของยอดรวมของธุรกรรมการซื้อ

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/refund-transactions?revenueType=GROSS&refundAmount=0.5&parentTxId=abf50909-2492-4bf5-8704-ade05f4d43b3&transactionNote=Refund for purchase transaction" \
-u email:password

คำตอบควรมีลักษณะเช่นนี้ (แสดงเพียงบางส่วนของคำตอบ):

{
  "application" : {
    ...
    },
    "product" : [ {
      ...
      
     {
      "customAtt1Name" : "user",
      "description" : "Payment",
      "displayName" : "Payment",
      "id" : "payment",
      "name" : "payment",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    } ],
    ...
  },
  "currency" : "USD",
  "developer" : {
    ...
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
      ...
    },
    ...
  },
  "endTime" : "2013-09-01 21:59:59",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8123,
  "gbpExchangeRate" : 0.6910,
  "grossPrice" : 0.5,
  "id" : "61f7eb88-f8cc-4cda-afd8-4a61fba3dd33",
  "isRevOnGrossOrNet" : "NET",
  "isVirtualCurrency" : false,
  "notes" : "Refund for purchase transaction",
  "itemDesc" : "test application",
  "netPrice" : 0.4464,
  "orgRevenueShareAmount" : 0.1339,
  "parentId" : "abf50909-2492-4bf5-8704-ade05f4d43b3",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  ...
  },
  "ratePlanLevel" : "STANDARD",
  "revenueShareAmount" : 0.3125,
  "startTime" : "2013-09-01 21:59:59",
  "status" : "SUCCESS",
  "tax" : 0.0536,
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "REFUND",
  "usdExchangeRate" : 1.0724,
  "utcEndTime" : "2013-09-01 21:59:59",
  "utcStartTime" : "2013-09-01 21:59:59"
}

การกำหนดค่าการคืนเงินสำหรับ API

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

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

ดูวิธีกําหนดเวลางานที่เกี่ยวข้องกับการสร้างรายได้และงานที่กําหนดเวลาไว้ โดยอัตโนมัติในกำหนดการ งานด้านการสร้างรายได้