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)

مطلوبة: نتيجة هذه المكالمة

نتيجة للتسوية

معلومات حول النتيجة النهائية للسداد

تمثيل 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)

اختياري: النتيجة الأولية لهذه الدفعة. يُستخدم هذا الخيار للمساعدة في تقديم معلومات عن محرك البحث والإحصاءات من Google. في حالات ربط الرمز، يتم فقدان البيانات أحيانًا. ومن الممكن أن يختار صاحب عملية التكامل منح Google رمزًا أوليًا. على سبيل المثال، قد تستخدم مدخل بطاقة الائتمان (المسؤول عن عملية الدمج) هذا الحقل لإعلام Google برمز الرفض الدقيق الذي تم تلقّيه من شبكة VISA. في هذه الحالة، ستكون scope هي "Visa" وسيكون 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 الأصلي.

رمز النتيجة في DisburseFunds

رموز النتائج لمكالمة إيداع الأموال.

عمليات التعداد
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 حساب المستخدم معلّق.

نتائج البحث الأولية

عرض نتيجة غير منسقة

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

string

اختياري: يمكن أن يكون نطاق الرمز الأولي فارغًا.
rawCode

string

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

DisburseFundsresultNotificationResultResultCode

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

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