Method: remittanceStatementNotification

يتم إبلاغ الجهة المكمّلة بسياسة تحويل الأموال الجديدة.

يتم إرسال إشعارات كشوفات الحساب كل مرة يتم فيها جمع كشف جديد يمثّل أموالاً ستدفعها 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)

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

ويتم ضبط هذه القيمة طالما أنّ totalDueByIntegrator أكبر من 0.
currencyCode

string

مطلوبة: رمز العملة بالتنسيق ISO 4217 المكوّن من 3 أحرف
totalDueByIntegrator

string (Int64Value format)

مطلوبة: تظهر هذه القيمة بوحدة Micro بوحدة currencyCode. هذه القيمة موجبة دائمًا.
remittanceInstructions

object (RemittanceInstructions)

مطلوبة: تفاصيل حول كيفية تحويل الدفعة

المدة الزمنية للفوترة

المدة الزمنية للفوترة في هذا كشف الحساب.

تمثيل JSON 
{
  "startDate": string,
  "endDate": string
}
الحقول
startDate

string (int64 format)

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

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

string (int64 format)

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

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

تعليمات التحويل المالي

تنظيم بنية معلومات الدفع حول كيفية دفع إشعار الحوالة المالية هذا

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

string

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

رمز كشف الإشعار

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

عمليات التعداد
UNKNOWN_RESULT عدم ضبط هذه القيمة التلقائية مطلقًا
ACCEPTED يقبل المسؤول عن عملية الدمج هذا البيان.