Method: disburseFundsResultNotification

يمكنك إشعار Google بنتيجة الدفع بعد إجراء استدعاء طريقة disburseFunds.

قيمة disburseFundsResult ثابتة لـ disburseFundsRequestId هذه، لذا يجب أن تكون قيمتها مطابقة للقيمة التي تم عرضها أثناء طلب disburseFunds ولا يمكن تغييرها عن طريق استدعاء لاحق لهذه الطريقة.

إذا واجهت نقطة النهاية خطأً أثناء معالجة الطلب، سيكون الرد من نقطة النهاية هذه من النوع ErrorResponse.

قد تكون الردود على هذا الطلب فارغة إذا لم تعرض هذه الطريقة رمز HTTP 200. يكون نص الاستجابة فارغًا في الحالات التي قد يتم فيها استخدام ErrorResponse مع وصف واضح لمساعدة المهاجم على فهم معرّف حساب شركة تكامل الدفع الخاص بالجهات المدمَجة الأخرى. في هذه الحالات، عندما يكون مفتاح التوقيع غير متطابق أو لم يتم العثور على معرّف وحدة تكامل الدفع أو كان مفتاح التشفير غير معروف، ستعرض هذه الطريقة خطأ HTTP 404 بدون نص. وإذا توفّرت إمكانية التحقّق من صحة توقيع الطلب، سيتم عرض معلومات إضافية بشأن الخطأ في نص الاستجابة.

إليك مثال على الطلب:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

يبدو الرد كمثال:


{
  "responseHeader": {
    "responseTimestamp": "1481852928324"
  },
  "result": "SUCCESS"
}

طلب HTTP

POST https://vgw.googleapis.com/secure-serving/gsp/v1/disburseFundsResultNotification/:PIAID

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
الحقول
requestHeader

object (RequestHeader)

مطلوب: عنوان مشترك لجميع الطلبات.
paymentIntegratorAccountId

string

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

string

مطلوبة: معرّف فريد لهذه المعاملة هذا هو requestId الذي أنشأته Google أثناء استدعاء disburseFunds الذي يرتبط به هذا الطلب.

هذه سلسلة لا يزيد طولها عن 100 حرف وتحتوي فقط على الأحرف "a-z" و"A-Z" و"0-9" و":" و"-" و"_".
disburseFundsResult

object (DisburseFundsResult)

مطلوب: نتيجة هذه المكالمة المتعلقة بتوزيع أموال.

نص الاستجابة

عنصر الاستجابة لطريقة disburseFundsResultNotification

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (DisburseFundsResultNotificationResultCode)
}
الحقول
responseHeader

object (ResponseHeader)

مطلوب: عنوان مشترك لجميع الردود.
result

enum (DisburseFundsResultNotificationResultCode)

REQUIRED: نتيجة هذه المكالمة.

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)

OPTIONAL: النتيجة الأولية لهذه الدفعة. تُستخدَم هذه السمة للمساعدة في إعلام محرّك بحث Google بشأن المخاطر والتحليلات. في حالات ربط الرموز البرمجية والرفض، يتم فقدان البيانات أحيانًا. يمكن أن تختار شركة الدمج منح Google رمزًا أوليًا. على سبيل المثال، يمكن لبوابة بطاقة الائتمان (شركة الدمج) استخدام هذا الحقل لإبلاغ Google برمز الرفض الذي تم استلامه من شبكة VISA. في هذه الحالة، ستكون القيمة scope هي "فيزا" وكانت بطاقة rawCode تعرض كل ما تعرضه شبكة VISA.

هذه القيمة مطلوبة إذا لم تكن قيمة السمة result هي SUCCESS.

حقل الاتحاد FailureDetail.

يمكن أن يكون FailureDetail واحدًا فقط مما يلي:
transactionMaxLimit

string (Int64Value format)

اختياري: إذا كانت قيمة disburseFundsResultCode هي DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT، تكون هذه هي قيمة الحد الأقصى للمعاملة المسموح بها. يُستخدم هذا الخيار للمراسلة المنظَّمة الموجَّهة للمستخدمين وتحليل معدّل الرفض.

هذا المقدار هو ميكرو من نفس currencyCode كطلب طريقة disburseFunds الأصلي.
transactionMinLimit

string (Int64Value format)

اختياري: إذا كانت قيمة disburseFundsResultCode هي DISBURSEMENT_UNDER_TRANSACTION_LIMIT، تكون هذه هي قيمة الحد الأدنى للمعاملة المسموح بها. يُستخدم هذا الخيار للمراسلة المنظَّمة الموجَّهة للمستخدمين وتحليل معدّل الرفض.

هذا المقدار هو ميكرو من نفس currencyCode كطلب طريقة disburseFunds الأصلي.

DisburseFundsResultCode

رموز النتائج الخاصة بمكالمة لتسديد الدفعات

عمليات التعداد
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

OPTIONAL: يمكن أن يكون نطاق RAWCode فارغًا.
rawCode

string

مطلوب: الرمز الأولي من شركة الدمج أو الأنظمة الفرعية المضمّنة فيه.

DisburseFundsResultNotificationResultCode

رموز النتائج لطريقة disburseFundsResultNotification.

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