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)

اختياري: تاريخ استحقاق الحوالة المالية. ويتم تمثيلها بالمللي ثانية من الحقبة. إنه تاريخ (وبالتالي سيبدأ دائمًا بالمللي ثانية من اليوم في المنطقة الزمنية للفوترة).

ويتم ضبطها طالما أنّ قيمة 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)

مطلوب: تاريخ بدء المدة الزمنية للفوترة. ويتم تمثيلها بالمللي ثانية من الحقبة. إنه تاريخ (وبالتالي سيبدأ دائمًا بالمللي ثانية من اليوم في المنطقة الزمنية للفوترة).

هذا هو أول مللي ثانية من يوم المدة الزمنية للفوترة، 00:00:00.000
endDate

string (int64 format)

مطلوب: تاريخ انتهاء المدة الزمنية للفوترة. ويتم تمثيلها بالمللي ثانية من الحقبة.

هذا آخر مللي ثانية من آخر يوم من مدة الفوترة، 23:59:59.999

RemittanceInstructions

بنية تحتوي على معلومات حول طريقة دفع إشعار الحوالة المالية هذا

تمثيل JSON 
{
  "memoLineId": string
}
الحقول
memoLineId

string

مطلوبة: المعرّف الذي يجب إدراجه في سطر المذكرة للدفعة لتحديد هوية الحوالة المالية

StatementNotificationResultCode

رموز النتائج لإشعار كشف الحساب.

عمليات التعداد
UNKNOWN_RESULT لا تضبط هذه القيمة التلقائية على الإطلاق.
ACCEPTED قبلت شركة الدمج هذه العبارة.