Method: remittanceStatementNotification

แจ้งผู้ผสานการทำงานเกี่ยวกับใบแจ้งยอดการส่งเงินใหม่

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

หากผู้รวมบริการส่งคืนสำเร็จ ระบบจะถือว่าใบแจ้งยอดได้รับการยอมรับและจะได้รับการชำระเงิน

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

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

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


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "0123434-statement-abc",
    "requestTimestamp": "1502632800000"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "remittanceStatementSummary": {
    "statementDate": "1502607600000",
    "billingPeriod": {
      "startDate": "1502434800000",
      "endDate": "1502521199000"
    },
    "dateDue": "1503212400000",
    "currencyCode": "INR",
    "totalDueByIntegrator": "1076000000",
    "remittanceInstructions": {
      "memoLineId": "stmt-1AB-pp0-invisi"
    }
  }
}

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


{
  "responseHeader": {
    "responseTimestamp": "1502632802000"
  },
  "paymentIntegratorStatementId": "334a",
  "result": "ACCEPTED"
}

คำขอ HTTP

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

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

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

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

object (RequestHeader)

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

string

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

object (RemittanceStatementSummary)

ต้องระบุ: สรุปใบแจ้งยอดการส่งเงินนี้

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

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

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

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

object (ResponseHeader)

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

string

ต้องระบุ: ตัวระบุที่ผู้ผสานการทำงานจะทราบคำสั่งนี้ นี่คือผู้ผสานรวมระบบ
result

enum (StatementNotificationResultCode)

ต้องระบุ: ผลของการแจ้งเตือนนี้

RemittanceStatementSummary

ออบเจ็กต์สรุปเกี่ยวกับใบแจ้งยอดการส่งเงิน

การแสดง JSON 
{
  "statementDate": string,
  "billingPeriod": {
    object (BillingPeriod)
  },
  "dateDue": string,
  "currencyCode": string,
  "totalDueByIntegrator": string,
  "remittanceInstructions": {
    object (RemittanceInstructions)
  }
}
ช่อง
statementDate

string (int64 format)

ต้องระบุ: วันที่ (ในอเมริกา/ลอสแอนเจลิส) ที่จัดทำคำชี้แจงนี้
billingPeriod

object (BillingPeriod)

ต้องระบุ: ช่วงเวลาที่เรียกเก็บเงินนี้ครอบคลุมใบแจ้งยอด
dateDue

string (int64 format)

ไม่บังคับ: วันที่ครบกำหนดการส่งเงิน ค่านี้จะแสดงเป็นมิลลิวินาทีจาก Epoch ซึ่งเป็นวันที่ (ดังนั้นจะเริ่มต้นในมิลลิวินาทีแรกของวันในเขตเวลาสำหรับการเรียกเก็บเงินเสมอ)

โดยจะตั้งค่าได้ตราบใดที่ totalDueByIntegrator มากกว่า 0
currencyCode

string

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

string (Int64Value format)

ต้องระบุ: ค่านี้อยู่ในหน่วยไมโครในสกุลเงิน currencyCode ค่านี้จะเป็นบวกเสมอ
remittanceInstructions

object (RemittanceInstructions)

ต้องระบุ: รายละเอียดเกี่ยวกับวิธีชำระเงิน

BillingPeriod

ช่วงเวลาที่เรียกเก็บเงินของใบแจ้งยอดนี้

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

string (int64 format)

ต้องระบุ: วันที่เริ่มต้นของช่วงเวลาที่เรียกเก็บเงิน ค่านี้จะแสดงเป็นมิลลิวินาทีจาก Epoch ซึ่งเป็นวันที่ (ดังนั้นจะเริ่มต้นในมิลลิวินาทีแรกของวันในเขตเวลาสำหรับการเรียกเก็บเงินเสมอ)

นี่คือมิลลิวินาทีแรกของวันในช่วงเวลาที่เรียกเก็บเงิน 00:00:00.000
endDate

string (int64 format)

ต้องระบุ: วันที่สิ้นสุดของช่วงเวลาที่เรียกเก็บเงิน ค่านี้จะแสดงเป็นมิลลิวินาทีจาก Epoch

นี่คือมิลลิวินาทีสุดท้ายของวันสุดท้ายของช่วงเวลาที่เรียกเก็บเงิน 23:59:59.999

RemittanceInstructions

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

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

string

ต้องระบุ: ตัวระบุที่จำเป็นต้องใส่ไว้ในบรรทัดใบเพิ่มหนี้สำหรับการชำระเงินเพื่อระบุการส่งเงิน

StatementNotificationResultCode

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

Enum
UNKNOWN_RESULT โปรดอย่าตั้งค่าเริ่มต้นนี้
ACCEPTED ผู้ผสานรวมยอมรับคำแถลงนี้