Method: disburseFundsResultNotification

แจ้ง Google เกี่ยวกับผลการชําระเงินให้หลังจากมีการโทรโดยใช้วิธี disburseFunds

ค่า disburseFundsResult เป็นค่าที่แตกต่างกันสําหรับ disburseFundsRequestId นี้ ดังนั้นค่าจะต้องเหมือนกับค่าที่แสดงผลในระหว่างการเรียกใช้ disburseFunds และไม่สามารถเปลี่ยนแปลงเมื่อมีการเรียกด้วยวิธีนี้ภายหลังได้

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

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

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


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

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


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

คำขอ HTTP

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

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

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

การแสดง JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
ช่อง
requestHeader

object (RequestHeader)

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

string

ต้องระบุ: ตัวระบุบัญชีของผู้ผสานรวมการชําระเงินที่เกิดขึ้น
disburseFundsRequestId

string

ต้องระบุ: ตัวระบุที่ไม่ซ้ําสําหรับธุรกรรมนี้ นี่คือ requestId ที่สร้างโดย Google ระหว่างการเรียก disburseFunds ที่เชื่อมโยงกับคําขอนี้

สตริงนี้มีความยาวอักขระได้สูงสุด 100 ตัว และมีเฉพาะอักขระ "a-z", "A-Z", "0-9", ":", "-" และ "_" เท่านั้น
disburseFundsResult

object (DisburseFundsResult)

ต้องระบุ: ผลของการโทรเพื่อรับเงินนี้

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

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

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

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

object (ResponseHeader)

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

enum (DisburseFundsResultNotificationResultCode)

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

ผลการจ่ายเงิน

ข้อมูลเกี่ยวกับผลสุดท้ายของการชําระเงิน

การแสดง JSON 
{
  "disburseFundsResultCode": enum (DisburseFundsResultCode),
  "rawResult": {
    object (RawResult)
  },

  // Union field FailureDetail can be only one of the following:
  "transactionMaxLimit": string,
  "transactionMinLimit": string
  // End of list of possible types for union field FailureDetail.
}
ช่อง
disburseFundsResultCode

enum (DisburseFundsResultCode)

ต้องระบุ: รหัสผลลัพธ์การชําระเงินนี้
rawResult

object (RawResult)

ไม่บังคับ: ผลการตรวจสอบการชําระเงินอัตโนมัติ ใช้เพื่อช่วยแจ้งเครื่องมือวิเคราะห์และความเสี่ยงของ Google ในสถานการณ์ปฏิเสธการแมปโค้ด บางครั้งข้อมูลอาจสูญหาย ผู้รวมบริการสามารถเลือกที่จะให้โค้ดดิบแก่ Google ตัวอย่างเช่น เกตเวย์บัตรเครดิต (ผู้รวมระบบ) อาจใช้ช่องนี้ในการสื่อสารกับ Google ด้วยรหัสการปฏิเสธที่ได้รับจากเครือข่าย VISA ในกรณีนี้ scope จะเป็น " Visa" และ rawCode จะเป็นอะไรก็ตามที่เครือข่าย VISA แสดงผล

ต้องระบุค่านี้หาก result ไม่ใช่ SUCCESS

ช่อง Union FailureDetail

FailureDetail ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
transactionMaxLimit

string (Int64Value format)

ไม่บังคับ: หาก disburseFundsResultCode คือ DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT ค่านี้จะเป็นมูลค่าของธุรกรรมสูงสุดที่อนุญาต ซึ่งใช้สําหรับการวิเคราะห์อัตราการรับส่งข้อความและอัตราการแสดงออกแก่ผู้ใช้

ซึ่งเท่ากับ micros ของ currencyCode เดียวกันกับการเรียกใช้เมธอด disburseFunds เดิม
transactionMinLimit

string (Int64Value format)

ไม่บังคับ: หาก disburseFundsResultCode คือ DISBURSEMENT_UNDER_TRANSACTION_LIMIT ค่านี้จะเป็นค่าของธุรกรรมขั้นต่ําที่อนุญาต ซึ่งใช้สําหรับการวิเคราะห์อัตราการรับส่งข้อความและอัตราการแสดงออกแก่ผู้ใช้

ซึ่งเท่ากับ micros ของ currencyCode เดียวกันกับการเรียกใช้เมธอด disburseFunds เดิม

รหัสผลการชําระเงิน

รหัสผลลัพธ์สําหรับการโทรศัพท์เพื่อรับเงิน

Enum
UNKNOWN_RESULT อย่าตั้งค่าเริ่มต้นนี้!
SUCCESS ชําระเงินสําเร็จแล้ว
DISBURSEMENT_UNDER_TRANSACTION_LIMIT จํานวนเงินที่เบิกจ่ายที่ขอไม่ตรงกับจํานวนเงินต่อธุรกรรมขั้นต่ําของผู้รวมระบบ หากใช้รหัสนี้ ให้เติมข้อมูลในช่องจํานวนธุรกรรมขั้นต่ํา transactionMinLimit เพื่อวัตถุประสงค์ในการรับส่งข้อความของผู้ใช้
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT จํานวนเงินที่ชําระที่ขอเกินขีดจํากัดสูงสุดของธุรกรรมต่อผู้ผสานรวม หากใช้โค้ดนี้ ให้ใส่ค่าจํากัดธุรกรรมในช่อง transactionMaxLimit เพื่อวัตถุประสงค์ในการรับส่งข้อความของผู้ใช้
ACCOUNT_CLOSED ปิดบัญชีผู้ใช้ที่ถูกระงับด้วยผู้รวมระบบแล้ว มูลค่าการแสดงผลนี้จะทําให้เครื่องมือของผู้ใช้ถูกปิดด้วย Google ผู้ใช้จะถูกบังคับให้เพิ่มเครื่องมือใหม่
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER มีการปิดบัญชีของผู้ใช้ที่มีผู้รวมระบบซึ่งจะถือว่าบัญชีถูกยึด มูลค่าการแสดงผลนี้จะทําให้เครื่องมือของผู้ใช้ถูกปิดด้วย Google ผู้ใช้จะถูกบังคับให้เพิ่มเครื่องมือใหม่
ACCOUNT_CLOSED_FRAUD มีการปิดบัญชีของผู้ใช้ของผู้รวมระบบที่ผสานรวมไว้เนื่องจากการฉ้อโกง มูลค่าการแสดงผลนี้จะทําให้เครื่องมือของผู้ใช้ถูกปิดด้วย Google ผู้ใช้จะถูกบังคับให้เพิ่มเครื่องมือใหม่
ACCOUNT_ON_HOLD บัญชีของผู้ใช้ถูกระงับ

ผลดิบ

วัตถุดิบ

การแสดง JSON 
{
  "scope": string,
  "rawCode": string
}
ช่อง
scope

string

ไม่บังคับ: ขอบเขตของ RawCode สามารถเว้นว่างไว้ได้
rawCode

string

ต้องระบุ: โค้ดดิบจากผู้รวมหรือระบบย่อยที่อยู่ภายใน

DisburseFundsResultNotificationResultCode

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

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