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

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

บทนำ

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

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

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

การโพสต์เงินคืนโดยใช้ UI แบบคลาสสิกของ Edge (Edge for 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

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

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

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