Method: disburseFunds

เริ่มการโอนเงินระหว่างผู้ประมวลผลการชำระเงินและบัญชีของลูกค้า ชุดค่าผสมของ requestId ภายในส่วนหัวและ paymentIntegratorAccountId เป็นคีย์ประจำตัวที่ใช้ระบุธุรกรรมนี้โดยไม่ซ้ำกัน การเปลี่ยนแปลงทั้งหมดในธุรกรรมนี้จะเติมค่า requestId ในช่อง disburseFundsRequestId

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

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


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "liUrreQY233839dfFFb24gaQM",
    "requestTimestamp": "1502220434778"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "upiDetails": {
      "vpa": "foo@icici"
  },
  "transactionDescription": "Google - Music",
  "currencyCode": "INR",
  "amount": "208000000"
}

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


{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "paymentIntegratorTransactionId": "aW50ZWdyYXRvciB0cmFuc2FjdGlvbiBpZA",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

คำขอ HTTP

POST https://www.integratorhost.example.com/v1/disburseFunds

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

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

การแสดง JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "transactionDescription": string,
  "currencyCode": string,
  "amount": string,

  // Union field destinationFopDetails can be only one of the following:
  "upiDetails": {
    object (UpiDetails)
  }
  // End of list of possible types for union field destinationFopDetails.
}
ช่อง
requestHeader

object (RequestHeader)

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

string

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

string

ต้องระบุ: นี่คือคำอธิบายธุรกรรมที่สามารถระบุไว้ในใบแจ้งยอดของลูกค้า แปลเป็นภาษาของ userLocale ที่พบใน requestHeader รูปแบบนี้สามารถเปลี่ยนแปลงได้โดยไม่ต้องแจ้งให้ทราบ และห้ามแยกวิเคราะห์เด็ดขาด
currencyCode

string

ต้องระบุ: รหัสสกุลเงิน 3 ตัวอักษรตามมาตรฐาน ISO 4217
amount

string (Int64Value format)

ต้องระบุ: จำนวนการซื้อเป็นไมโครของหน่วยสกุลเงิน

ฟิลด์การรวม destinationFopDetails

destinationFopDetails ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
upiDetails

object (UpiDetails)

ไม่บังคับ: รายละเอียดการชำระเงินสำหรับเครื่องมือ UPI โดยเฉพาะ

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

ออบเจ็กต์คำตอบสำหรับวิธีการจ่ายเงินคืน

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

การแสดง JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "paymentIntegratorTransactionId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
ช่อง
responseHeader

object (ResponseHeader)

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

string

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

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

object (DisburseFundsResult)

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

UpiDetails

รายละเอียดเกี่ยวกับบัญชี UPI ที่จะชำระเงิน

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

string

ต้องระบุ: ที่อยู่การชำระเงินเสมือน (VPA) ของผู้ใช้ที่ใช้สำหรับการโอนเงินโดยใช้โปรโตคอล UPI เช่น foo@icici

DisburseFundsResult

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

การแสดง 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

ฟิลด์การรวม 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 เดิม

DisburseFundsResultCode

รหัสผลลัพธ์สำหรับการโทรเพื่อจ่ายเงินให้

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 บัญชีของผู้ใช้ถูกระงับ

RawResult

ออบเจ็กต์ผลลัพธ์ที่เป็นข้อมูลดิบ

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

string

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

string

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