Method: refundResultNotification

แจ้ง Google เกี่ยวกับเงินคืนหลังจากมีการเรียกใช้วิธี refund

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

ค่า refundResult เป็นค่าที่ไม่ซ้ํากันสําหรับ refundRequestId นี้ ดังนั้นค่านี้จึงไม่สามารถเปลี่ยนแปลงด้วยการเรียกครั้งต่อๆ ไปได้

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

การตอบกลับการค้นหานี้อาจว่างเปล่าหากวิธีนี้ไม่แสดงผล HTTP 200 เนื้อหาการตอบกลับว่างเปล่าในกรณีที่มีการใช้ ErrorResponse พร้อมคําอธิบายที่ชัดเจนเพื่อช่วยให้ผู้โจมตีเข้าใจตัวระบุบัญชีของผู้รวมระบบการชําระเงินของผู้ผสานรวมรายอื่นๆ ในสถานการณ์เช่นนี้ หากคีย์การลงนามไม่ตรงกัน ไม่พบตัวระบุผู้ผสานรวมการชําระเงิน หรือไม่ทราบคีย์การเข้ารหัส เมธอดนี้จะแสดง 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)

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

รหัสผลลัพธ์การคืนเงิน

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

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 ดําเนินการคืนเงินไม่ได้เนื่องจากคําขออยู่นอกช่วงเวลาการคืนเงินที่อนุญาต

รหัสผลลัพธ์ของการแจ้งเตือนการคืนเงิน

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

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