Method: refundResultNotification

แจ้ง Google ถึงผลการคืนเงินหลังจากติดต่อเมธอด refund แล้ว

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

ค่า refundResult เป็นเลขประจำตัวสำหรับ refundRequestId นี้ ดังนั้นไม่สามารถเปลี่ยนแปลงค่าในการเรียกเมธอดนี้ในภายหลังได้

หากปลายทางพบข้อผิดพลาดขณะประมวลผลคำขอ การตอบกลับจากปลายทางนี้จะเป็นประเภท ErrorResponse

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

ตัวอย่างคำขอมีลักษณะดังนี้


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "HsKv5pvtQKTtz7rdcw1YqE",
    "requestTimestamp": "1481855928301"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "refundRequestId": "hH1T32PI86CpKwjuf6oD2r",
  "paymentIntegratorRefundId": "invisi/Id::xx__1243",
  "refundResult": "SUCCESS"
}

ตัวอย่างคำตอบจะมีลักษณะดังนี้


{
  "responseHeader": {
    "responseTimestamp": "1481855928376"
  },
  "result": "SUCCESS"
}

คำขอ HTTP

POST https://vgw.googleapis.com/secure-serving/gsp/v1/refundResultNotification/:PIAID

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "refundRequestId": string,
  "refundResult": enum (RefundResultCode),
  "paymentIntegratorRefundId": string
}
ช่อง
requestHeader

object (RequestHeader)

ต้องระบุ: ส่วนหัวทั่วไปสำหรับคำขอทั้งหมด
paymentIntegratorAccountId

string

ต้องระบุ: ตัวระบุบัญชีผู้ผสานรวมการชำระเงินที่เกิดการคืนเงิน
refundRequestId

string

ต้องระบุ: ตัวระบุที่ไม่ซ้ำกันสำหรับการคืนเงินนี้ สร้างโดยช่อง requestId เมื่อมีการเรียกใช้เมธอด refund
refundResult

enum (RefundResultCode)

ต้องระบุ: ผลลัพธ์ของการคืนเงินนี้
paymentIntegratorRefundId

string

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

ตัวระบุนี้จะรวมอยู่ในรายละเอียดการส่งเงินเพื่อความสะดวก

เนื้อหาการตอบกลับ

ออบเจ็กต์การตอบกลับสำหรับเมธอด refundResultNotification

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (RefundResultNotificationResultCode)
}
ช่อง
responseHeader

object (ResponseHeader)

ต้องระบุ: ส่วนหัวทั่วไปของคำตอบทั้งหมด
result

enum (RefundResultNotificationResultCode)

ต้องระบุ: ผลของการโทรนี้

RefundResultCode

รหัสผลลัพธ์ที่ไม่ซ้ำกันจะคืนเงิน

Enum
UNKNOWN_RESULT โปรดอย่าตั้งค่าเริ่มต้นนี้
SUCCESS คืนเงินสำเร็จ
NO_MONEY_LEFT_ON_TRANSACTION การคืนเงินล้มเหลว ไม่มีเงินเหลือในธุรกรรม ซึ่งมักเป็นข้อบกพร่องระหว่างผู้รวมระบบและ Google Google ไม่ควรขอคืนเงินมากกว่าจำนวนเงินที่หักในตอนแรก
ACCOUNT_CLOSED

ปิดบัญชีที่ระงับไว้กับผู้ผสานรวมแล้ว

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

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

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

บัญชีของผู้ใช้ที่ไว้กับผู้รวมระบบถูกปิดเนื่องจากการประพฤติมิชอบ

การแสดงค่านี้จะทำให้เครื่องมือของผู้ใช้ปิดด้วย Google ระบบจะบังคับให้ผู้ใช้เพิ่มเครื่องมือใหม่โดยทำตามขั้นตอนการเชื่อมโยงอีกครั้ง
ACCOUNT_ON_HOLD ขณะนี้ บัญชีของผู้ใช้ถูกระงับและไม่สามารถรับเงินคืนได้ แต่บัญชีของผู้ใช้สามารถยอมรับการคืนเงินได้ในภายหลัง Google อาจขอเงินคืนอีกครั้งในอนาคต แต่จะดำเนินการดังกล่าวด้วยrequestIdใหม่ ระบบจึงถือว่าคำขอนี้เสร็จสิ้นแล้ว
REFUND_EXCEEDS_MAXIMUM_BALANCE ไม่สามารถประมวลผลการคืนเงินได้ในขณะนี้ เนื่องจากจะทำให้ยอดคงเหลือของผู้ใช้เกินจำนวนสูงสุดที่อนุญาต Google อาจขอเงินคืนอีกครั้งในอนาคต แต่จะดำเนินการดังกล่าวด้วยrequestIdใหม่ ระบบจึงถือว่าคำขอนี้เสร็จสิ้นแล้ว
REFUND_WINDOW_EXCEEDED ไม่สามารถดำเนินการคืนเงินได้เนื่องจากคำขออยู่นอกระยะเวลาการคืนเงินที่อนุญาต

RefundResultNotificationResultCode

รหัสผลลัพธ์สำหรับเมธอด refundResultNotification

Enum
UNKNOWN_RESULT โปรดอย่าตั้งค่าเริ่มต้นนี้
SUCCESS การแจ้งเตือนผลการคืนเงินสำเร็จแล้ว