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)

ต้องระบุ: ผลของการแจ้งเตือนเกี่ยวกับใบแจ้งยอดนี้

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

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

การแสดง 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 ซึ่งเป็นวันที่ (ดังนั้นจึงเริ่มต้นที่ 1 มิลลิวินาทีแรกของวันในเขตเวลาสําหรับการเรียกเก็บเงิน)

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

string

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

string (Int64Value format)

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

object (RemittanceInstructions)

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

ช่วงเวลาที่เรียกเก็บเงิน

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

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

string (int64 format)

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

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

string (int64 format)

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

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

วิธีการส่งเงิน

โครงสร้างข้อมูลเกี่ยวกับวิธีชําระเงินในการส่งเงินนี้

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

string

ต้องระบุ: ตัวระบุที่ต้องระบุในบรรทัดบันทึกสําหรับการชําระเงินสําหรับการส่งเงิน

โค้ดผลลัพธ์การแจ้งเตือน

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

Enum
UNKNOWN_RESULT อย่าตั้งค่าเริ่มต้นนี้!
ACCEPTED Integrator ยอมรับข้อความนี้