Method: disburseFundsResultNotification

پس از برقراری تماس روش disburseFunds ، نتیجه پرداخت را به Google اطلاع دهید.

مقدار 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 کاراکتر است و فقط شامل کاراکترهای "az"، "AZ"، "0-9"، ":"، "-"، و "_" است.

disburseFundsResult

object ( DisburseFundsResult )

مورد نیاز : نتیجه این فراخوان پرداخت وجوه.

بدن پاسخگو

شی پاسخ برای روش disburseFundsResultNotification .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (DisburseFundsResultNotificationResultCode)
}
زمینه های
responseHeader

object ( ResponseHeader )

مورد نیاز : هدر مشترک برای همه پاسخ ها.

result

enum ( DisburseFundsResultNotificationResultCode )

الزامی : نتیجه این تماس.

Disburse Funds Result

اطلاعات در مورد نتیجه نهایی پرداخت.

نمایندگی 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 «ویزا» و 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

کدهای نتیجه برای تماس پرداخت وجوه.

Enums
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 حساب کاربری که نزد integrator نگهداری می شود به دلیل کلاهبرداری بسته شده است. این مقدار بازگشتی باعث می‌شود که ابزار کاربر با Google بسته شود. کاربر مجبور می شود یک ابزار جدید اضافه کند.
ACCOUNT_ON_HOLD حساب کاربری در حالت تعلیق است.

RawResult

شیء نتیجه خام.

نمایندگی JSON
{
  "scope": string,
  "rawCode": string
}
زمینه های
scope

string

اختیاری : محدوده rawCode، می تواند خالی باشد.

rawCode

string

مورد نیاز : کد خام از یکپارچه ساز یا زیرسیستم های درون آن.

DisburseFundsResultNotificationResultCode

کدهای نتیجه برای روش disburseFundsResultNotification .

Enums
UNKNOWN_RESULT هرگز این مقدار پیش فرض را تنظیم نکنید!
SUCCESS اعلان با موفقیت پردازش شد.